AI导哈

项目图MCP服务器

一个MCP服务器，允许AI代理以紧凑模式读取和编辑代码库，支持多语言解析、代码质量分析和数据库分析。

  • by rnd-pro
  • JavaScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 rnd-pro/project-graph-mcp

使用说明

项目图mcp

网站和文件

最大化AI代理的上下文窗口。 MCP服务器，允许代理读取和编辑您的代码库 紧凑模式 --压缩源代码，保留所有变量名。 .ctx 文档只注入到焦点区域，因此代理可以从结构开始，并在需要时请求实现细节。

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

特性

  • 项目框架 --紧凑的基于AST的JSON文件、符号和关系图
  • 压缩代码模式 --项目范围 compact/beautify；代理读取和编辑缩小的源代码，同时名称仍可用于还原
  • 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?
IDE 配置路径
反重力 ~/.gemini/antigravity/mcp_config.json
Gemini CLI ~/.gemini/settings.json
光标 .cursor/mcp.json
风帆冲浪 .windsurf/mcp.json
克劳德代码 运行： claude mcp add project-graph npx -y project-graph-mcp

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

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

注： 源代码校验不再需要前者 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-agent-portal 条目替换了子服务器的单独公共配置。

当您只需要项目图工具时，它也可以独立工作：

# Generate a config with the correct path for this server:
npx -y project-graph-mcp config
# Or use mcp-agent-portal as the unified orchestration gateway.

[！重要] 代理门户启动的代理工作人员可以使用他们自己的 project-graph-mcp 实例独立导航代码库，而不会阻塞主编排器。

文档

相关项目

许可证

MIT© RND-PRO.com

制作于❤️ RND-PRO团队

相关 MCP