claude-skills-mcp

# Claude Skills MCP Frontend Lightweight MCP proxy for Claude Skills that auto-downloads the heavy backend on demand. ## Overview This is the frontend component of the Claude Skills MCP system. It's a lightweight proxy (~15 MB) that: - Starts instantly (<5 seconds) - Auto-downloads the backend when first needed - Acts as MCP server (stdio) for Cursor - Acts as MCP client (HTTP) for the backend - Returns tool schemas immediately (no backend wait needed) ## Installation ```bash # Via uvx (recommended for Cursor) uvx claude-skills-mcp # Via uv tool (persistent install) uv tool install claude-skills-mcp # Via pip pip install claude-skills-mcp ``` ## Usage with Cursor Add to your Cursor MCP settings (`~/.cursor/mcp.json`): ```json { "mcpServers": { "claude-skills": { "command": "uvx", "args": ["claude-skills-mcp"] } } } ``` Restart Cursor and the skills will be available! ### First Run Behavior On first run, the frontend will: 1. Start immediately (~5 seconds) ✅ **Cursor timeout satisfied!** 2. Return tool schemas to Cursor (instant) 3. Download backend in background (~250 MB, 60-120 seconds) 4. When you first use a tool, you'll see "Loading backend..." 5. Once backend ready, all tools work normally **Subsequent runs**: Fast! Backend is already installed. ## Configuration The frontend forwards all arguments to the backend: ```bash # Custom configuration uvx claude-skills-mcp --config my-config.json # Verbose logging uvx claude-skills-mcp --verbose # Custom backend port (advanced) uvx claude-skills-mcp --port 9000 ``` ## Remote Backend (Future) ```bash # Connect to hosted backend instead of local uvx claude-skills-mcp --remote https://skills.k-dense.ai/mcp ``` **Note**: Remote backend support coming in v1.1.0 ## How It Works ``` Cursor → Frontend (stdio, ~15 MB) ↓ list_tools() → Returns hardcoded schemas INSTANTLY ✅ ↓ [Backend downloads in background...] ↓ call_too…