# Capy > Capy helps you turn any repo into a design system with a polished preview page. - **Type:** MCP server - **Install:** `agentstack add mcp-githubanant-capy` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [GithubAnant](https://agentstack.voostack.com/s/githubanant) - **Installs:** 0 - **Category:** [Integrations](https://agentstack.voostack.com/c/integrations) - **Latest version:** 0.1.0 - **License:** Apache-2.0 - **Upstream author:** [GithubAnant](https://github.com/GithubAnant) - **Source:** https://github.com/GithubAnant/capy - **Website:** https://capy.anants.studio ## Install ```sh agentstack add mcp-githubanant-capy ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About Capy MCP server that gives AI coding agents the context they need to build and update UI - preview pages & design-system artifacts. Website · npm · Docs --- ## What it does Capy inspects your React / Next.js repo and returns structured briefs so AI agents can implement UI changes with precision — no hallucinated components, no guessed tokens. **Three tools:** | Tool | Purpose | | ------------------- | --------------------------------------------------------------------------------------------- | | `get_preview_brief` | Returns repo map, inspection plan, constraints, and a `/preview` spec for the agent to follow | | `get_design_system` | Writes a machine-readable design-system JSON artifact (`.capy/design-system.json`) | | `update_preview` | Diffs against last snapshot, refreshes the design system, returns an incremental update brief | --- ## Quick start ```bash npx capy-mcp@latest ``` --- ## Setup Pick your client. One command or one config change — you're set. ### Agents Claude Code ```bash claude mcp add --scope user capy -- npx -y capy-mcp@latest ``` Or add to `~/.claude/mcp.json`: ```json { "mcpServers": { "capy": { "command": "npx", "args": ["-y", "capy-mcp@latest"] } } } ``` Claude Desktop Add to your config file: - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json` - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json` ```json { "mcpServers": { "capy": { "command": "npx", "args": ["-y", "capy-mcp@latest"] } } } ``` Codex ```bash codex mcp add capy -- npx -y capy-mcp@latest ``` Or add to `~/.codex/config.toml`: ```toml [mcp_servers.capy] command = "npx" args = ["-y", "capy-mcp@latest"] ``` Gemini CLI Add to `~/.gemini/settings.json`: ```json { "mcpServers": { "capy": { "command": "npx", "args": ["-y", "capy-mcp@latest"] } } } ``` Copilot CLI Add to `~/.vscode-server/data/User/mcp.json`: ```json { "servers": { "capy": { "type": "stdio", "command": "npx", "args": ["-y", "capy-mcp@latest"] } } } ``` > Make sure Copilot Chat is in Agent mode — MCP tools only work there. Mistral Vibe Add to `~/.vibe/config.toml`: ```toml [[mcp_servers]] name = "capy" transport = "stdio" command = "npx" args = ["-y", "capy-mcp@latest"] ``` Kimi Code ```bash kimi mcp add --transport stdio capy -- npx -y capy-mcp@latest ``` Or add to `~/.kimi/mcp.json`: ```json { "mcpServers": { "capy": { "command": "npx", "args": ["-y", "capy-mcp@latest"] } } } ``` OpenCode Add to `~/.config/opencode/opencode.json`: ```json { "$schema": "https://opencode.ai/config.json", "mcp": { "capy": { "type": "local", "command": ["npx", "-y", "capy-mcp@latest"], "enabled": true } } } ``` QwenCode Add to `settings.json`: ```json { "mcpServers": { "capy": { "command": "npx", "args": ["-y", "capy-mcp@latest"] } } } ``` ### IDEs Cursor Add to `~/.cursor/mcp.json`: ```json { "mcpServers": { "capy": { "command": "npx", "args": ["-y", "capy-mcp@latest"] } } } ``` VS Code Add to `~/.vscode-server/data/User/mcp.json`: ```json { "servers": { "capy": { "type": "stdio", "command": "npx", "args": ["-y", "capy-mcp@latest"] } } } ``` > Or via Command Palette: `MCP: Open User Configuration` Windsurf Add to `~/.codeium/windsurf/mcp.json`: ```json { "mcpServers": { "capy": { "command": "npx", "args": ["-y", "capy-mcp@latest"] } } } ``` Zed Add to your settings file: - **macOS:** `~/.zed/settings.json` - **Linux:** `~/.config/zed/settings.json` - **Windows:** `%USERPROFILE%\AppData\Roaming\Zed\settings.json` ```json { "context_servers": { "capy": { "command": "npx", "args": ["-y", "capy-mcp@latest"], "env": {} } } } ``` Antigravity Add to your config file: - **macOS:** `~/.gemini/antigravity/mcp_config.json` - **Windows:** `%USERPROFILE%\.gemini\antigravity\mcp_config.json` ```json { "mcpServers": { "capy": { "command": "npx", "args": ["-y", "capy-mcp@latest"] } } } ``` > Or via UI: Agent session → … dropdown → MCP Servers → Manage MCP Servers → View raw config. --- ## Library usage ```ts import { buildPreviewBrief, buildDesignSystemArtifact, runPreviewUpdate, detectFramework, } from "capy-mcp"; const brief = await buildPreviewBrief(process.cwd(), { task: "build_preview" }); const designSystem = await buildDesignSystemArtifact(process.cwd()); const update = await runPreviewUpdate(process.cwd()); ``` --- ## Local development ```bash cd capy-mcp npm install npm test npx capy-mcp ``` --- Built by Anant Singhal Twitter · GitHub · LinkedIn ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [GithubAnant](https://github.com/GithubAnant) - **Source:** [GithubAnant/capy](https://github.com/GithubAnant/capy) - **License:** Apache-2.0 - **Homepage:** https://capy.anants.studio Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-githubanant-capy - Seller: https://agentstack.voostack.com/s/githubanant - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.