Spaces:
Running
Running
| <html lang="en"> | |
| <head> | |
| <meta charset="utf-8"> | |
| <meta name="viewport" content="width=device-width, initial-scale=1"> | |
| <title>MCP Quickstart — Agent Stack</title> | |
| <style> | |
| :root { --bg: #1a1a1a; --fg: #e8e6e1; --muted: #9a9690; --accent: #d4a853; --card: #232323; --border: #353535; } | |
| * { box-sizing: border-box; } | |
| body { font: 16px/1.55 -apple-system, BlinkMacSystemFont, 'SF Pro Text', sans-serif; background: var(--bg); color: var(--fg); margin: 0; padding: 2rem 1.25rem; } | |
| main { max-width: 880px; margin: 0 auto; } | |
| h1 { color: var(--accent); font-size: 2.1rem; margin: 0 0 0.5rem; } | |
| h2 { color: var(--accent); font-size: 1.3rem; margin: 2rem 0 0.6rem; } | |
| h3 { color: var(--fg); margin: 1.2rem 0 0.4rem; font-size: 1rem; } | |
| .lede { color: var(--muted); font-size: 1.05rem; max-width: 680px; } | |
| pre { background: var(--card); border: 1px solid var(--border); padding: 1rem 1.1rem; border-radius: 8px; overflow-x: auto; font-family: ui-monospace, SF Mono, monospace; font-size: 0.85rem; line-height: 1.5; } | |
| code { background: var(--card); padding: 0.1rem 0.4rem; border-radius: 4px; font-family: ui-monospace, SF Mono, monospace; font-size: 0.88em; color: var(--accent); } | |
| ol li { margin-bottom: 0.5rem; } | |
| a { color: var(--accent); } | |
| footer { color: var(--muted); margin-top: 3rem; padding-top: 1.5rem; border-top: 1px solid var(--border); font-size: 0.9rem; } | |
| </style> | |
| </head> | |
| <body> | |
| <main> | |
| <h1>🧩 MCP Quickstart</h1> | |
| <p class="lede">Add the 5 agent-stack tools to any MCP client in under a minute. The npx commands work cross-platform — no Python or Node setup needed beyond what your client already has.</p> | |
| <h2>Claude Desktop</h2> | |
| <ol> | |
| <li>Open <code>~/Library/Application Support/Claude/claude_desktop_config.json</code> (macOS) or <code>%APPDATA%\Claude\claude_desktop_config.json</code> (Windows). Create the file if it doesn't exist.</li> | |
| <li>Paste the config below.</li> | |
| <li>Quit + reopen Claude Desktop.</li> | |
| <li>Look for the 🔨 hammer icon → you should see the 5 servers listed.</li> | |
| </ol> | |
| <pre>{ | |
| "mcpServers": { | |
| "agentfit": { "command": "npx", "args": ["-y", "@mukundakatta/agentfit-mcp"] }, | |
| "agentguard": { "command": "npx", "args": ["-y", "@mukundakatta/agentguard-mcp"] }, | |
| "agentsnap": { "command": "npx", "args": ["-y", "@mukundakatta/agentsnap-mcp"] }, | |
| "agentvet": { "command": "npx", "args": ["-y", "@mukundakatta/agentvet-mcp"] }, | |
| "agentcast": { "command": "npx", "args": ["-y", "@mukundakatta/agentcast-mcp"] } | |
| } | |
| }</pre> | |
| <h2>Cursor</h2> | |
| <p>Edit <code>~/.cursor/mcp.json</code> with the same shape.</p> | |
| <h2>Cline (VS Code)</h2> | |
| <p>Cline → Settings → MCP Servers → paste the same JSON (under <code>mcpServers</code>).</p> | |
| <h2>Windsurf</h2> | |
| <p>Settings → Cascade → MCP Servers → same JSON shape.</p> | |
| <h2>Zed</h2> | |
| <p><code>~/.config/zed/settings.json</code>:</p> | |
| <pre>{ | |
| "context_servers": { | |
| "agentfit": { "command": { "path": "npx", "args": ["-y", "@mukundakatta/agentfit-mcp"] } } | |
| } | |
| }</pre> | |
| <h2>Verify it works</h2> | |
| <p>In any MCP-aware chat, ask: <em>"Use agentvet to validate that the email tool got <code>{to: 'a@b.com', subject: 'hi'}</code> against the schema <code>{to: str, subject: str, body: str}</code>"</em>. The model will call into the MCP server and report back.</p> | |
| <p>Want to sanity-check your config first? Try the <a href="https://huggingface.co/spaces/mukunda1729/mcp-config-validator">MCP Config Validator</a>.</p> | |
| <footer> | |
| Part of <a href="https://mukundakatta.github.io/agent-stack/">The Agent Reliability Stack</a> · MIT licensed | |
| </footer> | |
| </main> | |
| </body> | |
| </html> | |