resolve-nvs-mcp 0.1.0__tar.gz

resolve_nvs_mcp-0.1.0/.gitignore

@@ -0,0 +1,4 @@
+dist/
+*.egg-info/
+__pycache__/
+.venv/

resolve_nvs_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: resolve-nvs-mcp
+Version: 0.1.0
+Summary: Resolve AI Copilot MCP server — connects Claude (and other MCP clients) to the Resolve API over stdio.
+Author-email: Resolve <team@jobescape.me>
+License: MIT
+Requires-Python: >=3.10
+Requires-Dist: anyio>=4.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp>=1.27.2
+Description-Content-Type: text/markdown
+
+# resolve-nvs-mcp
+
+Resolve AI Copilot MCP server. Connects Claude (and any MCP-compatible client) to the [Resolve](https://resolve.nvs.team) support platform over stdio — no repo clone, no database required.
+
+## Requirements
+
+- [`uv`](https://docs.astral.sh/uv/) installed (for `uvx`)
+- A Resolve API token (issue one at **Settings → API Keys** inside Resolve)
+
+## Add to Claude Desktop / Claude Code
+
+```bash
+claude mcp add resolve \
+  -e RESOLVE_API_TOKEN=rsv_... \
+  -e RESOLVE_API_URL=https://api.resolve.nvs.team \
+  -- uvx resolve-nvs-mcp
+```
+
+Replace `rsv_...` with your actual token. `RESOLVE_API_URL` is optional and defaults to `https://api.resolve.nvs.team`.
+
+## Local development
+
+Point the server at a locally running API instance:
+
+```bash
+RESOLVE_API_TOKEN=rsv_... RESOLVE_API_URL=http://localhost:8080 uvx resolve-nvs-mcp
+```
+
+## Environment variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `RESOLVE_API_TOKEN` | Yes | — | Plaintext API token (`rsv_...` prefix). Issue at `/settings/api-keys`. |
+| `RESOLVE_API_URL` | No | `https://api.resolve.nvs.team` | Base URL for the Resolve API. Use `http://localhost:8080` for local dev. |
+
+## How it works
+
+On startup the server fetches the available tool list from the API (`GET /api/v1/mcp/tools`), validates your token, and then serves those tools over the MCP stdio protocol. Every tool call is forwarded to the API (`POST /api/v1/mcp/tools/{name}`) — no local state or database access is involved.
+
+## License
+
+MIT

resolve_nvs_mcp-0.1.0/README.md

@@ -0,0 +1,42 @@
+# resolve-nvs-mcp
+
+Resolve AI Copilot MCP server. Connects Claude (and any MCP-compatible client) to the [Resolve](https://resolve.nvs.team) support platform over stdio — no repo clone, no database required.
+
+## Requirements
+
+- [`uv`](https://docs.astral.sh/uv/) installed (for `uvx`)
+- A Resolve API token (issue one at **Settings → API Keys** inside Resolve)
+
+## Add to Claude Desktop / Claude Code
+
+```bash
+claude mcp add resolve \
+  -e RESOLVE_API_TOKEN=rsv_... \
+  -e RESOLVE_API_URL=https://api.resolve.nvs.team \
+  -- uvx resolve-nvs-mcp
+```
+
+Replace `rsv_...` with your actual token. `RESOLVE_API_URL` is optional and defaults to `https://api.resolve.nvs.team`.
+
+## Local development
+
+Point the server at a locally running API instance:
+
+```bash
+RESOLVE_API_TOKEN=rsv_... RESOLVE_API_URL=http://localhost:8080 uvx resolve-nvs-mcp
+```
+
+## Environment variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `RESOLVE_API_TOKEN` | Yes | — | Plaintext API token (`rsv_...` prefix). Issue at `/settings/api-keys`. |
+| `RESOLVE_API_URL` | No | `https://api.resolve.nvs.team` | Base URL for the Resolve API. Use `http://localhost:8080` for local dev. |
+
+## How it works
+
+On startup the server fetches the available tool list from the API (`GET /api/v1/mcp/tools`), validates your token, and then serves those tools over the MCP stdio protocol. Every tool call is forwarded to the API (`POST /api/v1/mcp/tools/{name}`) — no local state or database access is involved.
+
+## License
+
+MIT

resolve_nvs_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "resolve-nvs-mcp"
+version = "0.1.0"
+description = "Resolve AI Copilot MCP server — connects Claude (and other MCP clients) to the Resolve API over stdio."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+  { name = "Resolve", email = "team@jobescape.me" },
+]
+dependencies = [
+  "mcp>=1.27.2",
+  "httpx>=0.27",
+  "anyio>=4.0",
+]
+
+[project.scripts]
+resolve-nvs-mcp = "resolve_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/resolve_mcp"]

resolve_nvs_mcp-0.1.0/src/resolve_mcp/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

resolve_nvs_mcp-0.1.0/src/resolve_mcp/server.py

@@ -0,0 +1,168 @@
+"""Stdio MCP server — authenticates via RESOLVE_API_TOKEN, proxies tool calls to the API.
+
+Run as:
+    RESOLVE_API_TOKEN=rsv_... uvx resolve-mcp
+
+The server reads the token and API base URL from the environment, validates the
+token by fetching the tool list from the API, and then serves tool calls over
+stdio using the low-level mcp.server.Server API.  All data access goes through
+the HTTPS API — no database or Redis connection is required.
+
+Environment variables:
+    RESOLVE_API_TOKEN   Required.  The plaintext API token (prefix rsv_...).
+    RESOLVE_API_URL     Optional.  Base URL for the Resolve API.
+                        Defaults to "https://api.resolve.nvs.team".
+"""
+from __future__ import annotations
+
+import json
+import os
+import sys
+
+import anyio
+import httpx
+import mcp.server.stdio
+import mcp.types as types
+from mcp.server.lowlevel import Server
+from mcp.server.models import InitializationOptions
+
+
+# ---------------------------------------------------------------------------
+# Small, testable HTTP helpers
+# ---------------------------------------------------------------------------
+
+
+async def fetch_tool_specs(base_url: str, token: str) -> list[dict]:
+    """GET {base_url}/api/v1/mcp/tools and return the list of tool spec dicts.
+
+    Raises RuntimeError on 401, connection errors, or unexpected responses.
+    """
+    url = f"{base_url}/api/v1/mcp/tools"
+    try:
+        async with httpx.AsyncClient() as client:
+            resp = await client.get(
+                url,
+                headers={"Authorization": f"Bearer {token}"},
+                timeout=30.0,
+            )
+    except httpx.ConnectError as exc:
+        raise RuntimeError(
+            f"Could not connect to Resolve API at {base_url}: {exc}"
+        ) from exc
+    except httpx.RequestError as exc:
+        raise RuntimeError(
+            f"HTTP error fetching tool specs from {url}: {exc}"
+        ) from exc
+
+    if resp.status_code == 401:
+        raise RuntimeError(
+            "RESOLVE_API_TOKEN is invalid or has been revoked (401 from API)."
+        )
+    if not resp.is_success:
+        raise RuntimeError(
+            f"Unexpected response from {url}: {resp.status_code} {resp.text[:200]}"
+        )
+
+    data = resp.json()
+    return data["tools"]
+
+
+async def call_tool_http(
+    base_url: str, token: str, name: str, args: dict
+) -> dict:
+    """POST {base_url}/api/v1/mcp/tools/{name} with JSON args and return the result dict.
+
+    Raises RuntimeError on non-2xx responses (with the response body included).
+    """
+    url = f"{base_url}/api/v1/mcp/tools/{name}"
+    try:
+        async with httpx.AsyncClient() as client:
+            resp = await client.post(
+                url,
+                json=args,
+                headers={"Authorization": f"Bearer {token}"},
+                timeout=120.0,
+            )
+    except httpx.RequestError as exc:
+        raise RuntimeError(
+            f"HTTP error calling tool {name!r} at {url}: {exc}"
+        ) from exc
+
+    if not resp.is_success:
+        detail = resp.text[:400]
+        raise RuntimeError(
+            f"API returned {resp.status_code} for tool {name!r}: {detail}"
+        )
+
+    return resp.json()
+
+
+# ---------------------------------------------------------------------------
+# Main entry point
+# ---------------------------------------------------------------------------
+
+
+async def _async_main() -> None:
+    token = os.environ.get("RESOLVE_API_TOKEN", "").strip()
+    if not token:
+        print(
+            "ERROR: RESOLVE_API_TOKEN environment variable is not set.",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    base_url = os.environ.get("RESOLVE_API_URL", "https://api.resolve.nvs.team").rstrip("/")
+
+    # -------------------------------------------------------------------------
+    # Validate the token and fetch tool specs in one shot (startup HTTP call).
+    # -------------------------------------------------------------------------
+    try:
+        tool_specs = await fetch_tool_specs(base_url, token)
+    except RuntimeError as exc:
+        print(f"ERROR: {exc}", file=sys.stderr)
+        sys.exit(1)
+
+    print(
+        f"resolve-copilot MCP server: connected to {base_url} ({len(tool_specs)} tools)",
+        file=sys.stderr,
+    )
+
+    # -------------------------------------------------------------------------
+    # Build the MCP server and register handlers.
+    # -------------------------------------------------------------------------
+    server = Server("resolve-copilot")
+
+    @server.list_tools()
+    async def handle_list_tools() -> list[types.Tool]:
+        return [
+            types.Tool(
+                name=spec["name"],
+                description=spec["description"],
+                inputSchema=spec["inputSchema"],
+            )
+            for spec in tool_specs
+        ]
+
+    @server.call_tool()
+    async def handle_call_tool(
+        name: str, arguments: dict | None
+    ) -> list[types.TextContent]:
+        result = await call_tool_http(base_url, token, name, arguments or {})
+        return [types.TextContent(type="text", text=json.dumps(result, indent=2))]
+
+    # -------------------------------------------------------------------------
+    # Run over stdio.
+    # -------------------------------------------------------------------------
+    init_options: InitializationOptions = server.create_initialization_options()
+
+    async with mcp.server.stdio.stdio_server() as (read_stream, write_stream):
+        await server.run(read_stream, write_stream, init_options)
+
+
+def main() -> None:
+    """Console entry point — invoked by `resolve-mcp` / `uvx resolve-mcp`."""
+    anyio.run(_async_main)
+
+
+if __name__ == "__main__":
+    main()