sciple-mcp 0.1.0__tar.gz

sciple_mcp-0.1.0/.env.example

@@ -0,0 +1,3 @@
+SCIPLE_API_URL=http://localhost:8000/api/v1
+SCIPLE_API_TOKEN=sciple_pat_your_personal_access_token_here
+SCIPLE_TENANT_ID=your-tenant-id-here

sciple_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,50 @@
+name: Publish to PyPI
+
+# Tag-driven release: bump `version` in pyproject.toml, commit, then
+#   git tag v0.1.0 && git push origin v0.1.0
+# Publishing pauses for manual approval (the `pypi` environment) before
+# the upload step runs.
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    name: Build sdist + wheel
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Upload built distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI via OIDC
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/sciple-mcp/
+    permissions:
+      # Required for PyPI Trusted Publishing (OIDC). No PyPI API token needed.
+      id-token: write
+    steps:
+      - name: Download built distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

sciple_mcp-0.1.0/.gitignore

@@ -0,0 +1,34 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+build/
+dist/
+.eggs/
+
+# uv / virtualenvs
+.venv/
+.python-version
+
+# Test / caches
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+
+# Env files (secrets — never commit)
+.env
+.env.local
+
+# Editors
+.vscode/
+.idea/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db

sciple_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: sciple-mcp
+Version: 0.1.0
+Summary: MCP server for populating and managing Sciple platform content
+Project-URL: Homepage, https://github.com/navaganeshr/sciple-mcp
+Project-URL: Source, https://github.com/navaganeshr/sciple-mcp
+Project-URL: Issues, https://github.com/navaganeshr/sciple-mcp/issues
+Project-URL: Documentation, https://github.com/navaganeshr/sciple-mcp#readme
+Author-email: Navaganesh Raju <navaganesh.raju@gmail.com>
+Keywords: anthropic,claude,mcp,model-context-protocol,sciple
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp[cli]>=1.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Description-Content-Type: text/markdown
+
+# Sciple Platform MCP Server
+
+MCP server that lets a local Claude populate and manage Sciple platform content — environments, environment groups, and services — via the Sciple REST API. Engineers use it to bootstrap tenant structure and maintain the service catalog without leaving their AI coding session.
+
+## Setup
+
+```bash
+cd services/sciple-mcp
+uv sync
+```
+
+**Environment variables** (`.env` or shell):
+
+```
+SCIPLE_API_URL=http://localhost:8000/api/v1
+SCIPLE_API_TOKEN=sciple_pat_...
+SCIPLE_TENANT_ID=<your tenant id>
+```
+
+`SCIPLE_API_TOKEN` is a personal access token minted under **Profile → Access tokens** in the dashboard, scoped to the permissions the server should have (e.g. `environments.view`, `environments.manage`, `services.view`, `services.manage`, `observability.view`, `observability.manage`). The PAT is single-tenant — its bound tenant must equal `SCIPLE_TENANT_ID`.
+
+## Wire into Claude Desktop / Claude Code
+
+Add to `~/.claude/claude_desktop_config.json` (or your Claude Code MCP config):
+
+```json
+{
+  "mcpServers": {
+    "sciple-platform": {
+      "command": "uv",
+      "args": ["run", "--project", "/path/to/services/sciple-mcp", "sciple-mcp"],
+      "env": {
+        "SCIPLE_API_URL": "http://localhost:8000/api/v1",
+        "SCIPLE_API_TOKEN": "sciple_pat_...",
+        "SCIPLE_TENANT_ID": "..."
+      }
+    }
+  }
+}
+```
+
+Then restart Claude Desktop or Claude Code. You should see 17 platform tools available.
+
+## Tools
+
+### Environments
+
+| Tool | Description |
+|---|---|
+| `list_environments` | List all environments in the tenant (id, name, slug, group, default flag) |
+| `create_environment` | Create an environment with optional group assignment and default flag |
+| `update_environment` | Update an environment's name, description, group, or sort order |
+| `delete_environment` | Delete an environment by id (irreversible) |
+| `list_environment_groups` | List environment groups (id, name, slug, AWS account binding) |
+| `create_environment_group` | Create an environment group with optional AWS account binding |
+
+### Observability
+
+| Tool | Description |
+|---|---|
+| `list_dashboards` | List all observability dashboards in the tenant (id, name, panel count) |
+| `get_dashboard` | Get a dashboard's name, description, and panel list |
+| `create_dashboard` | Create a new dashboard with optional description |
+| `update_dashboard` | Replace a dashboard's name and description (full PUT; name required) |
+| `delete_dashboard` | Delete a dashboard and all its panels (irreversible) |
+| `add_panel` | Add a panel to a dashboard with optional PromQL query |
+| `delete_panel` | Delete a panel from a dashboard (irreversible) |
+
+### Services
+
+| Tool | Description |
+|---|---|
+| `list_services` | List all services in the tenant catalog (id, name, slug) |
+| `create_service` | Create a service in the catalog with kind, language, SCM provider, and repository |
+| `update_service` | Update a service's metadata, lifecycle, owner, tags, links, or environment associations |
+| `delete_service` | Delete a service from the catalog by id (irreversible) |
+
+## Security
+
+The server can only do what the PAT's scope allows. Attempts to write without the relevant manage permission return a 403 from the API and are surfaced as an error in Claude's response. The PAT is revocable at any time from **Profile → Access tokens** in the Sciple dashboard — revoking it immediately cuts off the server's access without any config change.

sciple_mcp-0.1.0/README.md

@@ -0,0 +1,80 @@
+# Sciple Platform MCP Server
+
+MCP server that lets a local Claude populate and manage Sciple platform content — environments, environment groups, and services — via the Sciple REST API. Engineers use it to bootstrap tenant structure and maintain the service catalog without leaving their AI coding session.
+
+## Setup
+
+```bash
+cd services/sciple-mcp
+uv sync
+```
+
+**Environment variables** (`.env` or shell):
+
+```
+SCIPLE_API_URL=http://localhost:8000/api/v1
+SCIPLE_API_TOKEN=sciple_pat_...
+SCIPLE_TENANT_ID=<your tenant id>
+```
+
+`SCIPLE_API_TOKEN` is a personal access token minted under **Profile → Access tokens** in the dashboard, scoped to the permissions the server should have (e.g. `environments.view`, `environments.manage`, `services.view`, `services.manage`, `observability.view`, `observability.manage`). The PAT is single-tenant — its bound tenant must equal `SCIPLE_TENANT_ID`.
+
+## Wire into Claude Desktop / Claude Code
+
+Add to `~/.claude/claude_desktop_config.json` (or your Claude Code MCP config):
+
+```json
+{
+  "mcpServers": {
+    "sciple-platform": {
+      "command": "uv",
+      "args": ["run", "--project", "/path/to/services/sciple-mcp", "sciple-mcp"],
+      "env": {
+        "SCIPLE_API_URL": "http://localhost:8000/api/v1",
+        "SCIPLE_API_TOKEN": "sciple_pat_...",
+        "SCIPLE_TENANT_ID": "..."
+      }
+    }
+  }
+}
+```
+
+Then restart Claude Desktop or Claude Code. You should see 17 platform tools available.
+
+## Tools
+
+### Environments
+
+| Tool | Description |
+|---|---|
+| `list_environments` | List all environments in the tenant (id, name, slug, group, default flag) |
+| `create_environment` | Create an environment with optional group assignment and default flag |
+| `update_environment` | Update an environment's name, description, group, or sort order |
+| `delete_environment` | Delete an environment by id (irreversible) |
+| `list_environment_groups` | List environment groups (id, name, slug, AWS account binding) |
+| `create_environment_group` | Create an environment group with optional AWS account binding |
+
+### Observability
+
+| Tool | Description |
+|---|---|
+| `list_dashboards` | List all observability dashboards in the tenant (id, name, panel count) |
+| `get_dashboard` | Get a dashboard's name, description, and panel list |
+| `create_dashboard` | Create a new dashboard with optional description |
+| `update_dashboard` | Replace a dashboard's name and description (full PUT; name required) |
+| `delete_dashboard` | Delete a dashboard and all its panels (irreversible) |
+| `add_panel` | Add a panel to a dashboard with optional PromQL query |
+| `delete_panel` | Delete a panel from a dashboard (irreversible) |
+
+### Services
+
+| Tool | Description |
+|---|---|
+| `list_services` | List all services in the tenant catalog (id, name, slug) |
+| `create_service` | Create a service in the catalog with kind, language, SCM provider, and repository |
+| `update_service` | Update a service's metadata, lifecycle, owner, tags, links, or environment associations |
+| `delete_service` | Delete a service from the catalog by id (irreversible) |
+
+## Security
+
+The server can only do what the PAT's scope allows. Attempts to write without the relevant manage permission return a 403 from the API and are surfaced as an error in Claude's response. The PAT is revocable at any time from **Profile → Access tokens** in the Sciple dashboard — revoking it immediately cuts off the server's access without any config change.

sciple_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "sciple-mcp"
+version = "0.1.0"
+description = "MCP server for populating and managing Sciple platform content"
+readme = "README.md"
+requires-python = ">=3.12"
+authors = [
+    { name = "Navaganesh Raju", email = "navaganesh.raju@gmail.com" },
+]
+keywords = ["mcp", "sciple", "claude", "anthropic", "model-context-protocol"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: System :: Systems Administration",
+]
+dependencies = [
+    "mcp[cli]>=1.0.0",
+    "httpx>=0.27.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.urls]
+Homepage      = "https://github.com/navaganeshr/sciple-mcp"
+Source        = "https://github.com/navaganeshr/sciple-mcp"
+Issues        = "https://github.com/navaganeshr/sciple-mcp/issues"
+Documentation = "https://github.com/navaganeshr/sciple-mcp#readme"
+
+[project.scripts]
+sciple-mcp = "sciple_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/sciple_mcp"]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "respx>=0.21.0",
+]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"

sciple_mcp-0.1.0/src/sciple_mcp/client.py

@@ -0,0 +1,46 @@
+"""Thin async HTTP client wrapping the Sciple REST API.
+
+Authenticates with a Sciple personal access token (PAT). The PAT is sent as a
+Bearer token; the API's get_bearer resolves it on data routes, and X-Tenant-ID
+selects the tenant (which must match the PAT's bound tenant).
+"""
+import httpx
+
+
+class ScipleClient:
+    def __init__(self, base_url: str, token: str, tenant_id: str) -> None:
+        self._base = base_url.rstrip("/")
+        self._headers = {
+            "Authorization": f"Bearer {token}",
+            "X-Tenant-ID": tenant_id,
+            "Content-Type": "application/json",
+        }
+
+    async def get(self, path: str) -> object:
+        async with httpx.AsyncClient() as http:
+            r = await http.get(f"{self._base}{path}", headers=self._headers)
+            r.raise_for_status()
+            return r.json()
+
+    async def post(self, path: str, body: dict | None = None) -> object:
+        async with httpx.AsyncClient() as http:
+            r = await http.post(f"{self._base}{path}", headers=self._headers, json=body or {})
+            r.raise_for_status()
+            return r.json()
+
+    async def patch(self, path: str, body: dict) -> object:
+        async with httpx.AsyncClient() as http:
+            r = await http.patch(f"{self._base}{path}", headers=self._headers, json=body)
+            r.raise_for_status()
+            return r.json()
+
+    async def put(self, path: str, body: dict) -> object:
+        async with httpx.AsyncClient() as http:
+            r = await http.put(f"{self._base}{path}", headers=self._headers, json=body)
+            r.raise_for_status()
+            return r.json()
+
+    async def delete(self, path: str) -> None:
+        async with httpx.AsyncClient() as http:
+            r = await http.delete(f"{self._base}{path}", headers=self._headers)
+            r.raise_for_status()

sciple_mcp-0.1.0/src/sciple_mcp/server.py

@@ -0,0 +1,42 @@
+"""Sciple platform MCP server — exposes platform CRUD tools to a local Claude.
+
+Auth: a Sciple personal access token (PAT) in SCIPLE_API_TOKEN. The server's
+reach is whatever the PAT's scope grants; out-of-scope writes fail server-side.
+"""
+import os
+
+from dotenv import load_dotenv
+from mcp.server.fastmcp import FastMCP
+
+from sciple_mcp.client import ScipleClient
+from sciple_mcp.tools import environments, observability, services
+
+load_dotenv()
+
+mcp = FastMCP("Sciple Platform")
+
+_client: ScipleClient | None = None
+
+
+def _get_client() -> ScipleClient:
+    global _client
+    if _client is None:
+        _client = ScipleClient(
+            base_url=os.environ["SCIPLE_API_URL"],
+            token=os.environ["SCIPLE_API_TOKEN"],
+            tenant_id=os.environ["SCIPLE_TENANT_ID"],
+        )
+    return _client
+
+
+environments.register(mcp, _get_client)
+observability.register(mcp, _get_client)
+services.register(mcp, _get_client)
+
+
+def main() -> None:
+    mcp.run(transport="stdio")
+
+
+if __name__ == "__main__":
+    main()

sciple_mcp-0.1.0/src/sciple_mcp/tools/environments.py

@@ -0,0 +1,138 @@
+"""Environment + environment-group tools — populate the platform's env structure.
+
+Wraps the REST routes:
+  GET/POST   /environments          GET/PATCH/DELETE /environments/{id}
+  GET/POST   /envgroups             GET/PATCH/DELETE /envgroups/{id}
+Requires the PAT to hold environments.view (reads) / environments.manage (writes).
+"""
+from __future__ import annotations
+
+from collections.abc import Callable
+
+from sciple_mcp.client import ScipleClient
+
+
+def register(mcp, get_client: Callable[[], ScipleClient]) -> None:
+
+    @mcp.tool()
+    async def list_environments() -> str:
+        """List all environments in the tenant (id, name, slug, group, default flag)."""
+        envs = await get_client().get("/environments")
+        if not envs:
+            return "No environments found."
+        lines = []
+        for e in envs:
+            default = " [default]" if e.get("is_default") else ""
+            grp = f" group={e['environment_group_id']}" if e.get("environment_group_id") else ""
+            lines.append(f"- {e['name']} (id={e['id']}, slug={e['slug']}){default}{grp}")
+        return "\n".join(lines)
+
+    @mcp.tool()
+    async def create_environment(
+        name: str,
+        slug: str | None = None,
+        environment_group_id: str | None = None,
+        description: str | None = None,
+        is_default: bool = False,
+        display_order: int = 0,
+    ) -> str:
+        """Create an environment.
+
+        Args:
+            name: Display name, e.g. "Production".
+            slug: URL-safe id; server generates one from name if omitted.
+            environment_group_id: Optional parent environment-group id.
+            description: Optional human description.
+            is_default: Mark this the tenant's default environment.
+            display_order: Sort order in the UI (lower = earlier).
+        """
+        body: dict = {"name": name, "is_default": is_default, "display_order": display_order}
+        if slug is not None:
+            body["slug"] = slug
+        if environment_group_id is not None:
+            body["environment_group_id"] = environment_group_id
+        if description is not None:
+            body["description"] = description
+        e = await get_client().post("/environments", body)
+        return f"Created environment '{e['name']}' (id={e['id']}, slug={e['slug']})."
+
+    @mcp.tool()
+    async def update_environment(
+        env_id: str,
+        name: str | None = None,
+        description: str | None = None,
+        environment_group_id: str | None = None,
+        is_default: bool | None = None,
+        display_order: int | None = None,
+    ) -> str:
+        """Update an environment. Only provided fields change.
+
+        Args:
+            env_id: The environment id to update.
+            name: New display name.
+            description: New description.
+            environment_group_id: Move to a different environment group.
+            is_default: Set/unset default.
+            display_order: New sort order.
+        """
+        body: dict = {}
+        for key, val in (
+            ("name", name), ("description", description),
+            ("environment_group_id", environment_group_id),
+            ("is_default", is_default), ("display_order", display_order),
+        ):
+            if val is not None:
+                body[key] = val
+        if not body:
+            return "Nothing to update — provide at least one field."
+        e = await get_client().patch(f"/environments/{env_id}", body)
+        return f"Updated environment '{e['name']}' (id={e['id']})."
+
+    @mcp.tool()
+    async def delete_environment(env_id: str) -> str:
+        """Delete an environment by id. This cannot be undone.
+
+        Args:
+            env_id: The environment id to delete.
+        """
+        await get_client().delete(f"/environments/{env_id}")
+        return f"Deleted environment {env_id}."
+
+    @mcp.tool()
+    async def list_environment_groups() -> str:
+        """List environment groups (id, name, slug, aws account binding)."""
+        groups = await get_client().get("/envgroups")
+        if not groups:
+            return "No environment groups found."
+        lines = []
+        for g in groups:
+            acct = f" aws={g['aws_account_id']}" if g.get("aws_account_id") else ""
+            lines.append(f"- {g['name']} (id={g['id']}, slug={g['slug']}){acct}")
+        return "\n".join(lines)
+
+    @mcp.tool()
+    async def create_environment_group(
+        name: str,
+        slug: str | None = None,
+        description: str | None = None,
+        display_order: int = 0,
+        aws_account_id: str | None = None,
+    ) -> str:
+        """Create an environment group.
+
+        Args:
+            name: Display name, e.g. "Production accounts".
+            slug: URL-safe id; generated from name if omitted.
+            description: Optional description.
+            display_order: Sort order in the UI.
+            aws_account_id: Optional AWS account id to bind the group to.
+        """
+        body: dict = {"name": name, "display_order": display_order}
+        if slug is not None:
+            body["slug"] = slug
+        if description is not None:
+            body["description"] = description
+        if aws_account_id is not None:
+            body["aws_account_id"] = aws_account_id
+        g = await get_client().post("/envgroups", body)
+        return f"Created environment group '{g['name']}' (id={g['id']}, slug={g['slug']})."