Ganglia

Ganglia — 代码图 MCP 服务

Ganglia 是一个 MCP 服务，能让 AI 编码 Agent 真正理解你的代码库——理解的不是文件内容，而是结构：谁调用了什么、修改 X 会导致什么问题，以及某个路由最终会到达数据库的哪里。

它会将你的项目编入调用图，并提供语义工具，取代 Read / Grep / Glob，大幅减少在真实代码库中的 token 用量。适用于 Claude Code、Cursor、Windsurf、Continue、Cline、Goose，以及任何兼容 MCP 的客户端。

你将获得

类别	工具
读取	code_get、code_signature、code_files、code_toc、code_overview、code_summary、code_structure、code_search、code_grep、code_quick
导航	code_callers、code_callees、code_context、code_related、code_trace、code_imports
分析	code_impact、code_hotspots、code_dead、code_cycles、code_duplicates、code_breaking_changes、code_diff_context、code_changelog、code_map
重构（事务性）	code_propagate、code_apply_batch、code_revert、code_history、code_rename_symbol、code_safe_move、code_slice、code_verify_edit
架构与路由	code_route、code_route_trace、code_schema、code_env、code_type、code_type_usages
记忆与知识	code_memory、code_knowledge、code_annotate、code_checkpoint、code_config
构建 / 测试 / 代码检查	code_build、code_test、code_lint、code_exec
审议	deliberation_start、deliberation_opinion、deliberation_status、deliberation_result
智能（由大模型驱动）	code_smart_read、code_smart_grep、code_smart_diff、code_smart_context
文档图	doc_index、doc_list、doc_toc、doc_query、doc_get

完整参考：ganglia.dev/tools · 文档：ganglia.dev/docs

安装

Claude Code（插件市场）

/plugin marketplace add ganglia-tools/marketplace
/plugin install ganglia@ganglia

包含 5 个斜杠命令和一个自动触发的安全重构技能。

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "ganglia": {
      "command": "npx",
      "args": ["-y", "-p", "@ganglia/cli", "gng", "mcp", "-p", "."]
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "ganglia": {
      "command": "npx",
      "args": ["-y", "-p", "@ganglia/cli", "gng", "mcp", "-p", "."]
    }
  }
}

Continue / Cline / Goose / 任意 MCP 客户端

格式相同——指定 gng mcp -p . 命令：

npx -y -p @ganglia/cli gng mcp -p .

直接安装二进制文件

npm install -g @ganglia/cli
gng register                 # wires Claude Code automatically

也可以从 npm 或下载页面获取适用于你平台的二进制文件。

激活

公开测试期间免费。一次性设置：

1. 注册：https://ganglia.dev/signup（30 秒，填写姓名和邮箱）
2. 从 https://ganglia.dev/dashboard 复制你的密钥
3. gng login <your-key>

验证：gng whoami 会显示你的套餐等级。

使用理由

不使用 Ganglia	使用 Ganglia
AI 为了找到一个函数而读取整个文件	code_get("functionName")——只需 40 行，而非 800 行
AI 在整个代码树中盲目搜索	code_grep("pattern", max_results=5)——结果经过排序且结构清晰
AI 猜测修改函数会造成什么影响	code_impact(name, depth=2)——按严重程度评分的依赖项
跨文件重命名 = 47 次单独的 Edit() 调用	code_propagate → code_apply_batch——一个事务，一次回滚
每次会话都从头开始	code_memory——在不同对话间保留上下文

在真实代码库中的 token 节省：相比直接读取文件的模式，80–95%。

语言

TypeScript · JavaScript · Rust · Python · Go · PHP

仓库结构

.claude-plugin/
├── marketplace.json   # Marketplace declaration (one plugin: "ganglia")
├── plugin.json        # Plugin manifest, points at mcp.json
└── mcp.json           # MCP server: npx -y -p @ganglia/cli gng mcp -p .
commands/              # 5 Claude Code slash commands
skills/                # gng-safe-refactor skill
smithery.yaml          # Smithery.ai auto-discovery manifest

链接

• 网站：https://ganglia.dev
• 文档：https://ganglia.dev/docs
• 工具参考：https://ganglia.dev/tools
• npm：https://www.npmjs.com/package/@ganglia/cli
• AI 安装指南：https://ganglia.dev/INSTALL.md

Ganglia 源码位于私有仓库中。此仓库是面向公众的发行版，包含清单、安装说明和集成胶水代码。欢迎在此提交问题和功能请求。