Hugging Face's logo

Spaces:
mukunda1729
/
mcp-quickstart
Running

App Files Community
mukunda1729 commited on
Commit
889dc75
·
verified ·
1 Parent(s): 57ee44b

Initial: MCP setup guide for 5 clients

Browse files
Files changed (2) hide show
  1. README.md +12 -5
  2. index.html +71 -17
README.md CHANGED
@@ -1,10 +1,17 @@
1
  ---
2
- title: Mcp Quickstart
3
- emoji: 😻
4
- colorFrom: yellow
5
- colorTo: purple
6
  sdk: static
7
  pinned: false
 
 
 
 
 
 
 
8
  ---
9
 
10
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
1
  ---
2
+ title: MCP Quickstart — Agent Stack
3
+ emoji: 🧩
4
+ colorFrom: indigo
5
+ colorTo: yellow
6
  sdk: static
7
  pinned: false
8
+ license: mit
9
+ short_description: "Add the agent-stack MCP servers to your client in 60s."
10
+ tags:
11
+ - mcp
12
+ - claude-desktop
13
+ - cursor
14
+ - cline
15
  ---
16
 
17
+ How to add the 5 agent-stack MCP servers to Claude Desktop, Cursor, Cline, Windsurf, or Zed.
index.html CHANGED
@@ -1,19 +1,73 @@
1
  <!doctype html>
2
- <html>
3
- <head>
4
- <meta charset="utf-8" />
5
- <meta name="viewport" content="width=device-width" />
6
- <title>My static Space</title>
7
- <link rel="stylesheet" href="style.css" />
8
- </head>
9
- <body>
10
- <div class="card">
11
- <h1>Welcome to your static Space!</h1>
12
- <p>You can modify this app directly by editing <i>index.html</i> in the Files and versions tab.</p>
13
- <p>
14
- Also don't forget to check the
15
- <a href="https://huggingface.co/docs/hub/spaces" target="_blank">Spaces documentation</a>.
16
- </p>
17
- </div>
18
- </body>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
19
  </html>
 
1
  <!doctype html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="utf-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1">
6
+ <title>MCP Quickstart — Agent Stack</title>
7
+ <style>
8
+ :root { --bg: #1a1a1a; --fg: #e8e6e1; --muted: #9a9690; --accent: #d4a853; --card: #232323; --border: #353535; }
9
+ * { box-sizing: border-box; }
10
+ 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; }
11
+ main { max-width: 880px; margin: 0 auto; }
12
+ h1 { color: var(--accent); font-size: 2.1rem; margin: 0 0 0.5rem; }
13
+ h2 { color: var(--accent); font-size: 1.3rem; margin: 2rem 0 0.6rem; }
14
+ h3 { color: var(--fg); margin: 1.2rem 0 0.4rem; font-size: 1rem; }
15
+ .lede { color: var(--muted); font-size: 1.05rem; max-width: 680px; }
16
+ 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; }
17
+ 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); }
18
+ ol li { margin-bottom: 0.5rem; }
19
+ a { color: var(--accent); }
20
+ footer { color: var(--muted); margin-top: 3rem; padding-top: 1.5rem; border-top: 1px solid var(--border); font-size: 0.9rem; }
21
+ </style>
22
+ </head>
23
+ <body>
24
+ <main>
25
+ <h1>🧩 MCP Quickstart</h1>
26
+ <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>
27
+
28
+ <h2>Claude Desktop</h2>
29
+ <ol>
30
+ <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>
31
+ <li>Paste the config below.</li>
32
+ <li>Quit + reopen Claude Desktop.</li>
33
+ <li>Look for the 🔨 hammer icon → you should see the 5 servers listed.</li>
34
+ </ol>
35
+
36
+ <pre>{
37
+ "mcpServers": {
38
+ "agentfit": { "command": "npx", "args": ["-y", "@mukundakatta/agentfit-mcp"] },
39
+ "agentguard": { "command": "npx", "args": ["-y", "@mukundakatta/agentguard-mcp"] },
40
+ "agentsnap": { "command": "npx", "args": ["-y", "@mukundakatta/agentsnap-mcp"] },
41
+ "agentvet": { "command": "npx", "args": ["-y", "@mukundakatta/agentvet-mcp"] },
42
+ "agentcast": { "command": "npx", "args": ["-y", "@mukundakatta/agentcast-mcp"] }
43
+ }
44
+ }</pre>
45
+
46
+ <h2>Cursor</h2>
47
+ <p>Edit <code>~/.cursor/mcp.json</code> with the same shape.</p>
48
+
49
+ <h2>Cline (VS Code)</h2>
50
+ <p>Cline → Settings → MCP Servers → paste the same JSON (under <code>mcpServers</code>).</p>
51
+
52
+ <h2>Windsurf</h2>
53
+ <p>Settings → Cascade → MCP Servers → same JSON shape.</p>
54
+
55
+ <h2>Zed</h2>
56
+ <p><code>~/.config/zed/settings.json</code>:</p>
57
+ <pre>{
58
+ "context_servers": {
59
+ "agentfit": { "command": { "path": "npx", "args": ["-y", "@mukundakatta/agentfit-mcp"] } }
60
+ }
61
+ }</pre>
62
+
63
+ <h2>Verify it works</h2>
64
+ <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>
65
+
66
+ <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>
67
+
68
+ <footer>
69
+ Part of <a href="https://mukundakatta.github.io/agent-stack/">The Agent Reliability Stack</a> · MIT licensed
70
+ </footer>
71
+ </main>
72
+ </body>
73
  </html>