symbols-mcp

mcp-name: io.github.symbo-ls/symbols-mcp

MCP server for Symbols.app — provides documentation search, code generation, conversion, auditing, project management, publishing/deployment, and CLI/SDK reference tools for AI coding assistants (Cursor, Claude Code, Windsurf, claude.ai, etc.).

No API keys required for documentation tools. Project management tools require a Symbols account (login or API key).

Tools

Documentation & Generation

Project Management & Publishing

End-to-End Flow (from claude.ai or any MCP client)

1. generate_component  → JS source code
2. convert_to_json     → platform JSON
3. login               → get token
4. create_project      → (if new project needed)
   list_projects       → (or pick existing)
5. save_to_project     → push JSON to platform (creates version)
6. publish             → make version live
7. push                → deploy to environment

Resources

Skills (documentation)

Reference (inline)

Prompts

Installation

pip install symbols-mcp

Or with uv (no install needed):

uvx symbols-mcp

Or via npm:

npx @symbo.ls/mcp

Configuration

Recommended (auto-updates on every launch)

{
  "mcpServers": {
    "symbols": {
      "command": "uvx",
      "args": ["--refresh", "symbols-mcp"]
    }
  }
}

The --refresh flag checks PyPI for a newer version each time the server starts. Adds ~1-2s to startup but ensures you always have the latest rules and documentation.

Alternative configs

npm (also auto-updates):

{
  "mcpServers": {
    "symbols": {
      "command": "npx",
      "args": ["-y", "@symbo.ls/mcp"]
    }
  }
}

Pinned version (manual updates):

{
  "mcpServers": {
    "symbols": {
      "command": "uvx",
      "args": ["symbols-mcp"]
    }
  }
}

Manual update

# pip
pip install --upgrade symbols-mcp

# uv (clear cache and re-run)
uv cache clean symbols-mcp && uvx symbols-mcp

# npm
npm update -g @symbo.ls/mcp

Transport modes

By default, the server runs over stdio. For SSE transport:

MCP_TRANSPORT=sse MCP_HOST=0.0.0.0 MCP_PORT=8080 uvx symbols-mcp