cocalc-api: MCP server stub

Author: haraldschilly

src/python/cocalc-api/.vscode/settings.json

@@ -1,7 +1,14 @@
 {
-    "python.defaultInterpreterPath": "./.venv/bin/python",
+    "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python",
+    "python.linting.enabled": true,
     "python.analysis.extraPaths": ["./src"],
     "python.analysis.autoSearchPaths": true,
     "python.analysis.autoImportCompletions": true,
-    "pylance.insidersChannel": "off"
+    "python.analysis.typeCheckingMode": "basic",
+    "[python]": {
+        "editor.defaultFormatter": "charliermarsh.ruff",
+        "editor.formatOnSave": true
+    },
+    "pylance.insidersChannel": "off",
+    "python.venvFolderPath": ".venv"
 }

src/python/cocalc-api/Makefile

@@ -11,6 +11,7 @@ help:
 	@echo "  coverage         - Run tests with coverage reporting (HTML + terminal)"
 	@echo "  coverage-report  - Show coverage report in terminal"
 	@echo "  coverage-html    - Generate HTML coverage report only"
+	@echo "  mcp              - Start the MCP server (requires COCALC_API_KEY and COCALC_PROJECT_ID)"
 	@echo "  serve-docs       - Serve documentation locally"
 	@echo "  build-docs       - Build documentation"
 	@echo "  publish          - Build and publish package"
@@ -47,6 +48,9 @@ coverage-report:
 coverage-html:
 	uv run coverage html
 
+mcp:
+	uv run cocalc-mcp-server
+
 serve-docs:
 	uv run mkdocs serve
 

src/python/cocalc-api/pyproject.toml

@@ -4,8 +4,8 @@ version = "0.5.0"
 description = "Python client for the CoCalc API"
 authors = [{ name="William Stein", email="[email protected]" }, {name="Harald Schilly", email="[email protected]"}]
 readme = "README.md"
-requires-python = ">=3.9"
-dependencies = ["httpx"]
+requires-python = ">=3.10"
+dependencies = ["httpx", "mcp>=0.1.0"]
 license = "MIT"
 
 [tool.hatch.build.targets.wheel]
@@ -19,6 +19,9 @@ Documentation = "https://cocalc.com/api/python"
 Source = "https://github.com/sagemathinc/cocalc/src/python/cocalc-api"
 Issues = "https://github.com/sagemathinc/cocalc/issues"
 
+[project.scripts]
+cocalc-mcp-server = "cocalc_api.mcp.server:main"
+
 [tool.mypy]
 python_version = "3.13"
 # strict = true