Capacities-MCP-Plus

# Session Summary: December 14, 2025 ## Overview Fixed the failing Capacities MCP server, rebranded it as `capacities-mcp-plus`, published to npm, and submitted to multiple MCP directories. --- ## Initial Problem **Symptom:** Capacities MCP server failing to connect in Claude Desktop on Windows. **Log Error 1:** ``` 'npx' is not recognized as an internal or external command spawn npx ENOENT ``` **Solution:** Added `cmd` wrapper to Claude Desktop config: ```json { "mcpServers": { "capacities": { "command": "cmd", "args": ["/c", "npx", "-y", "capacities-mcp-plus"], "env": { "CAPACITIES_API_KEY": "your_key_here" } } } } ``` **Log Error 2:** ``` Error: Server does not support completions (required for completion/complete) ``` **Root Cause:** Outdated `fastmcp` version (1.27.3) incompatible with newer MCP SDK. --- ## Code Changes ### 1. Updated fastmcp version **File:** `package.json` ```diff - "fastmcp": "^1.27.3" + "fastmcp": "^3.25.4" ``` ### 2. Fixed prepublishOnly script for Windows **File:** `package.json` ```diff - "prepublishOnly": "bun run build" + "prepublishOnly": "npm run build" ``` ### 3. Renamed package for independent publishing **File:** `package.json` ```diff - "name": "capacities-mcp" - "version": "1.0.3" + "name": "capacities-mcp-plus" + "version": "1.0.0" - "capacities-mcp": "dist/server.js" + "capacities-mcp-plus": "dist/server.js" ``` ### 4. Updated repository metadata **File:** `package.json` ```diff - "repository": { "url": "git+https://github.com/jemgold/capacities-mcp.git" } - "author": "Jem Gold <591643+jemgold@users.noreply.github.com>" - "homepage": "https://github.com/jemgold/capacities-mcp" + "repository": { "url": "git+https://github.com/Im-Hal-9K/capacities-mcp.git" } + "author": "Im-Hal-9K" + "homepage": "https://github.com/Im-Hal-9K/capacities-mcp" ``` ### 5. Updated README.md - Changed title to "Capacities MCP Plus" - Added Glama badge - Added "What's Different from the Original" comparison table - Added Windows installation instructions with cmd wrapper - Added "Reading Content" example prompts - Added Credits section acknowledging original author (Jem Gold) - Updated all repository links to Im-Hal-9K fork ### 6. Added Glama integration **New File:** `glama.json` ```json { "name": "Capacities MCP Plus", "description": "Enhanced MCP server for Capacities knowledge management...", "author": "Im-Hal-9K", "repository": "https://github.com/Im-Hal-9K/capacities-mcp", "npm": "capacities-mcp-plus", "categories": ["knowledge-management", "note-taking", "productivity"], "tools": [...] } ``` --- ## Git Commits | Commit | Message | |--------|---------| | `4b68765` | fix: update fastmcp to v3.25.4 to fix MCP SDK compatibility | | `0f8e9cd` | fix: use npm instead of bun in prepublishOnly for Windows compatibility | | `4a49e62` | chore: bump version to 1.0.3 | | `e1466e4` | feat: rename package to capacities-mcp-plus | | `b1084d0` | docs: update README for capacities-mcp-plus | | `fe2f287` | chore: add Glama directory integration | | `fa88eb2` | chore: bump version to 1.0.2 | --- ## npm Publishing **Package:** `capacities-mcp-plus` **Final Version:** `1.0.2` **URL:** https://www.npmjs.com/package/capacities-mcp-plus ### Publishing Notes - Created npm access token ("J.R.R. Token") with read/write permissions - Set token via: `npm config set //registry.npmjs.org/:_authToken=TOKEN` - Published with: `npm publish --access public` --- ## Directory Submissions ### 1. Anthropic Official MCP Servers **Repo:** https://github.com/modelcontextprotocol/servers **Action:** Forked to Im-Hal-9K/servers, added entry, submitted PR **Status:** Pending review **Entry added:** ```markdown - **[Capacities MCP Plus](https://github.com/Im-Hal-9K/capacities-mcp)** - Enhanced MCP server for [Capacities](https://capacities.io) knowledge management. List spaces, search content, read full object content, save weblinks, and manage daily notes. Windows-compatible with cmd wrapper support. ``` ### 2. Glama MCP Directory **URL:** https://glama.ai/mcp/servers/@Im-Hal-9K/Capacities-MCP-Plus **Action:** Added glama.json, added badge to README, synced repo **Status:** Listed ### 3. awesome-mcp-servers **Repo:** https://github.com/punkpeye/awesome-mcp-servers **Action:** Forked, added entry, submitted PR **Status:** Submitted **Entry added:** ```markdown - [Capacities MCP Plus](https://github.com/Im-Hal-9K/capacities-mcp) 📇 ☁️ 🍎 🪟 🐧 - Enhanced MCP server for Capacities knowledge management with full object content retrieval. ``` ### 4. MCP.so **URL:** https://mcp.so **Action:** Submitted via web form **Status:** Submitted **Details:** - Type: MCP Server - Name: Capacities MCP Plus - URL: https://github.com/Im-Hal-9K/capacities-mcp - Tags: capacities, knowledge-management, note-taking, productivity, pkm, daily-notes, weblinks, search, typescript, mcp --- ## What's Different: capacities-mcp-plus vs original | Feature | Original (jemgold) | Plus (Im-Hal-9K) | |---------|-------------------|------------------| | **Read Object Content** | Not available | Retrieve full note content by object ID | | **fastmcp Version** | 1.27.3 | 3.25.4 (fixes MCP SDK compatibility) | | **Windows Support** | May have issues | Tested with cmd wrapper | | **npm Package** | `capacities-mcp` | `capacities-mcp-plus` | --- ## Still TODO - [ ] Submit Raindrop MCP to directories - [ ] Coding projects (mentioned for later) --- ## Lessons Learned 1. Windows needs `cmd /c` wrapper for npx in Claude Desktop MCP config 2. Can't publish to npm package you don't own - need your own package name 3. npm 2FA requires granular access token with "bypass 2FA" for CLI publishing 4. Glama uses glama.json for metadata and auto-scans GitHub repos 5. Keep repo name and package name in sync to avoid confusion (optional but helpful)