Project Graph MCP

](https://www.npmjs.com/package/project-graph-mcp)  ](https://nodejs.org)

项目图mcp

最大化AI代理的上下文窗口。 MCP服务器，允许代理读取和编辑您的代码库 紧凑模式 --压缩源代码，保留所有变量名。代码令牌掉落 ↓40%，以及 .ctx 文档仅被注入到焦点区域。每个文件的令牌更少→ 更多文件适合上下文→ 对代码库有更深入的理解.

\[！提示\] 18个MCP工具，零配置。 在MCP配置中添加一行，服务器将在下次IDE重启时自行下载。

特性

• 项目框架 --基于AST的图形，压缩10-50x，压缩了整个代码库的JSON表示
• 压缩代码模式 --项目范围 compact/beautify，代理直接读取和编辑压缩源代码（双向↓40%令牌）
• AI上下文层 --一个调用加载骨架+文档+压缩文件；渐进加载（概述→ 焦点）
• 代码质量分析 --死代码、复杂性、重复、大文件、遗留模式、JSDoc一致性、健康评分（0-100）
• 多语言分析器 --JavaScript（AST/Acorn）、TypeScript、Python、Go（基于正则表达式）
• Doc方言 --自动生成 .ctx 带有AST签名的文档、过时检测、自我丰富 @enrich 标记物
• 数据库分析 --从SQL迁移、表使用、死表中提取模式
• 测试检查表 --持续测试状态 .ctx.md 代理驱动的文件 mark_test_passed
• Monorepo支持 --子项目的自动发现 packages/, apps/, services/
• 框架规则 --React、Vue、Next.js、Express、NestJS、TypeScript、Node.js、Symbiote.js的11个规则集（86个规则）
• 安全 --所有操作的路径遍历保护

快速开始

为您的IDE生成MCP配置（使用正确的路径）：

npx -y project-graph-mcp config

将输出JSON复制到IDE的MCP配置文件中，然后重新启动。

Where is my MCP config file?

看 配置.md 适用于所有支持的IDE。

Alternative: from source

git clone --recursive https://github.com/rnd-pro/project-graph-mcp
cd project-graph-mcp
npm install

注： 这 --recursive 需要标志才能获取 vendor/symbiote-node 子模块。

命令行界面

npx project-graph-mcp skeleton src/       # Project skeleton
npx project-graph-mcp expand SN           # Expand minified symbol
npx project-graph-mcp deps SNG            # Get dependencies
npx project-graph-mcp deadcode src/       # Find unused code
npx project-graph-mcp complexity src/     # Cyclomatic complexity
npx project-graph-mcp analyze src/        # Full health analysis
npx project-graph-mcp compress src/f.js   # Compress file for AI
npx project-graph-mcp docs src/           # Project docs (doc-dialect)
npx project-graph-mcp generate-ctx src/   # Generate .context/ docs
npx project-graph-mcp compact src/ --dry-run  # Compact all files
npx project-graph-mcp mode .              # Show current editing mode
npx project-graph-mcp help                # All commands

Web仪表板

\[！注意\] project-graph-mcp 是一个 纯stdio MCP服务器 --它不包括web服务器。对于可视化UI（文件树、代码查看器、依赖关系图、实时监控、市场），请安装 mcp代理门户: npx mcp-agent-portal.

MCP生态系统

最好用作 mcp代理门户 --一个统一的MCP聚合器，将所有RND-PRO服务器组合在一个配置条目后面：

{
  "mcpServers": {
    "agent-portal": {
      "command": "npx",
      "args": ["-y", "mcp-agent-portal"]
    }
  }
}

\[！提示\] 门户网站运行一个 单例后端 以防止打开多个IDE窗口时资源耗尽。它透明地孕育 project-graph-mcp 和 agent-pool-mcp 当孩子处理和聚合他们的工具时。一个条目替换所有子服务器的单独配置。

也可独立或并行工作 代理池mcp --多代理任务委托：

# Generate configs with correct paths for both servers:
npx -y project-graph-mcp config
npx -y agent-pool-mcp config
# Or use mcp-agent-portal which bundles both.

\[！重要\] 每个Gemini CLI worker都会自动生成自己的实例 project-graph-mcp --工作人员独立地浏览代码库，而不会阻塞主代理。

文档

• 配置.md --所有支持的IDE的设置
• GUIDE.md --包含所有工具的全面使用指南
• 建筑.md --源代码结构
• AGENT_ROLE.md --代理商全系统提示
• ROADMAP.md --功能路线图和待办事项列表

相关项目

• mcp代理门户 --统一的MCP聚合器+web仪表板+AI代理运行时
• 代理池mcp --通过Gemini CLI进行多代理编排
• Symbiote.js --同构反应式Web组件框架
• JSDA工具包 --用于现代web应用程序的SSG/SSR工具包

许可证

MIT© RND-PRO.com

______________________________________________________________________

由...制作❤️ RND-PRO团队