capacities -bridge-unofficial

This MCP server provides an unofficial bridge suite for Capacities.io via a Node.js bridge script. It enables Claude Desktop to communicate with Capacities through a simplified tool naming bridge, and also supports direct MCP link usage for IDE plugins via simple SSE endpoints. The repository includes three setup paths: a Claude Desktop integration using a bridge script, a Simple SSE client workflow for IDEs, and an advanced self-hosted server option for Genspark or other self-hosted environments. To use it, clone the repository, install dependencies, and run the bridge script with Node.js to expose an MCP-compatible endpoint that your Capacities clients can connect to. Generate your unique MCP link using the provided mcp-link.vercel.app tool with the Capacities OpenAPI spec, then configure your client (Claude Desktop or IDE plugin) to point at the resulting MCP URL. The bridge translates simple tool names into the MCP names required by Capacities, enabling automation of saving links, daily notes, and search capabilities through your chosen client.

Prerequisites:

• Node.js (LTS version)
• npm (comes with Node.js)

Step-by-step:

1. Install Node.js from the official site and ensure node and npm are in your system PATH.
2. Clone the repository: git clone https://github.com/natkitten/capacities-mcp-bridge-unofficial.git
3. Navigate into the project folder: cd capacities-mcp-bridge-unofficial
4. Install dependencies: npm install
5. Build/configure the bridge (if needed):
   • For Claude Desktop integration, ensure capacities-claude-bridge.js references the generated MCP URL via SSE_URL.
6. Run the bridge: node capacities-claude-bridge.js
7. Generate your MCP link:
   • Open https://mcp-link.vercel.app/
   • Use the OpenAPI URL for Capacities: https://gist.githubusercontent.com/natkitten/e6ce1335c2cdad87a9237156c5cda315/raw/capacities_openapi_2.json
   • Set API Base URL to https://api.capacities.io
   • Set the Authorization header to: Authorization: Bearer YOUR_CAPACITIES_API_TOKEN
   • Leave Path Filters empty and choose Base64 (JSON Encoded)
   • Generate and copy the URL, then paste it into capacities-claude-bridge.js as SSE_URL.

Notes:

• If you prefer the Simple SSE setup for IDEs, you only need to generate the MCP link and point your IDE configuration to that URL.
• For self-hosted usage (Genspark), follow the advanced setup steps described in the README to host the server on your VPS.

Tips and caveats:

• You’ll need a Capacities API token with appropriate permissions for the actions you intend to perform (read spaces, save links, daily notes, etc.).
• The MCP Link Generator tool is essential for creating the server URL that your bridge will use.
• The provided setup emphasizes a Claude Desktop bridge and simple SSE usage for IDEs; if you’re hosting your own server (Genspark), you’ll rely on a self-hosted Node.js instance behind your own infrastructure.
• Be mindful of Capacities API rate limits per token (as noted in the README). Avoid excessive requests, especially if you’re using the bridge for automated tasks.
• Ensure you replace placeholder paths with real absolute paths in your Claude Desktop configuration when using the bridge script.
• If you encounter issues, verify Node.js version compatibility and ensure dependencies are installed (npm install).