Symbols MCP Server

MCP服务器符号

MCP（模型上下文协议）服务器，将Symbols/DOMQL v3 AI助手功能暴露给任何MCP兼容平台-- 光标, 克劳德代码, 帆板运动以及更多。

特性

工具

资源

提示

______________________________________________________________________

安装

快速启动（不需要API密钥！）

1. 克隆存储库:

git clone https://github.com/baronsilver/symbols-mcp-server.git
cd symbols-mcp-server

1. 安装依赖项:

pip install uv
uv sync
npm i @symbo.ls/cli -g
smbls create your-project

重要提示：目前，请在创建后删除项目文件夹中的docs文件夹

1. 配置:

cp .env.example .env
# Edit .env and add both:
# - SYMBOLS_MCP_URL (contact maintainer for public server URL)
# - LLM_MODEL=google/gemini-3-flash-preview

平台集成

克劳德代码

claude mcp add symbols-mcp -- uv run --directory C:\repos\symbols-mcp-server symbols-mcp

或手动编辑 ~/UserName/.claude.json:

{
  "mcpServers": {
    "symbols-mcp": {
      "command": "python",
      "args": [
        "-m",
        "uv",
        "run",
        "--directory",
        "C:\\repos\\symbols-mcp-server",
        "symbols-mcp"
      ]
    }
  }
}

光标

添加到光标MCP设置(.cursor/mcp.json 在项目或全局设置中）：

{
  "mcpServers": {
    "symbols-mcp": {
      "command": "python",
      "args": [
        "-m",
        "uv",
        "run",
        "--directory",
        "C:\\repos\\symbols-mcp-server",
        "symbols-mcp"
      ]
    }
  }
}

帆板运动

增添 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "symbols-mcp": {
      "command": "python",
      "args": [
        "-m",
        "uv",
        "run",
        "--directory",
        "C:\\repos\\symbols-mcp-server",
        "symbols-mcp"
      ]
    }
  }
}

发展

更新MCP设置后重新启动平台。加载后，它应该自动运行MCP。让你的AI用MCP进行快速测试，看看它是否正常工作。

______________________________________________________________________

环境变量

______________________________________________________________________

建筑

symbols-mcp-server/
├── pyproject.toml              # Project config and dependencies
├── .env.example                # Environment variable template
├── README.md                   # This file
└── symbols_mcp/
    ├── __init__.py
    ├── server.py               # MCP server with tools, resources, prompts
    └── skills/                 # Bundled Symbols knowledge base
        ├── CLAUDE.md           # DOMQL v3 complete reference
        ├── SYMBOLS_LOCAL_INSTRUCTIONS.md  # Project structure rules
        ├── DESIGN_DIRECTION.md # UI/UX design direction
        ├── MIGRATE_TO_SYMBOLS.md # Framework migration guide
        ├── DOMQL_v2-v3_MIGRATION.md # v2→v3 changes
        └── QUICKSTART.md       # CLI quickstart

服务器在启动时读取技能文件，并将其用作所有AI驱动工具的上下文。 配置Supabase后 search_symbols_docs 该工具还可以查询矢量数据库 以获取其他文档匹配。

______________________________________________________________________