Hugging Face's logo

Spaces:
mukunda1729
/
mcp-quickstart
Running

App Files Community
mcp-quickstart
File size: 3,670 Bytes
57ee44b
889dc75
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
57ee44b
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
<!doctype html>
<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>