rnd-pro/project-graph-mcp

[](https://www.npmjs.com/package/project-graph-mcp) [](https://opensource.org/licenses/MIT) [](https://nodejs.org) # 项目图-MCP **最大化您的 AI 代理的上下文窗口。** 一个允许代理以**紧凑模式**读取和编辑您的代码库的 MCP 服务器——保留所有变量名的压缩源代码。代码标记减少**↓40**%，并且仅在焦点区域注入 `.ctx` 文档。每文件标记更少→更多文件适合上下文→**更深入地理解您的代码库**。   ## 功能 - **项目骨架**——基于 AST 的图，压缩 10-50 倍，整个代码库的压缩 JSON 表示 - **紧凑代码模式**——项目范围的 `compact`/`beautify`，代理可以直接读取和编辑压缩源代码（双向减少 40% 标记） - **AI 上下文层**——一次调用加载骨架 + 文档 + 压缩文件；渐进式加载（概述 → 焦点） - **代码质量分析**——死代码、复杂性、重复项、大文件、遗留模式、JSDoc 一致性、健康分数（0-100） - **多语言解析器**——JavaScript（AST/Acorn）、TypeScript、Python、Go（基于正则表达式） - **文档方言**——自动生成的 `.ctx` 文档，带有 AST 签名、陈旧性检测、自丰富 `@enrich` 标记 - **数据库分析**——从 SQL 迁移中提取模式、表使用情况、死表 - **测试清单**——`.ctx.md` 文件中的持久测试状态，代理驱动 `mark_test_passed` - **单一代码库支持**——自动发现 `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 配置文件中，然后重启。

我的 MCP 配置文件在哪里？

| IDE | 配置路径 | |-----|------------| | Antigravity | `~/.gemini/antigravity/mcp_config.json` | | Gemini CLI | `~/.gemini/settings.json` | | Cursor | `.cursor/mcp.json` | | Windsurf | `.windsurf/mcp.json` | | Claude Code | 运行：`claude mcp add project-graph npx -y project-graph-mcp` | 参见 **[CONFIGURATION.md](CONFIGURATION.md)** 了解所有支持的 IDE。

替代方案：从源代码

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

### 命令行界面 ``` 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 ``` ### 网络仪表板 ## MCP 生态系统 最好作为 [**mcp-agent-portal**](https://github.com/rnd-pro/mcp-agent-portal) 的部分使用——一个统一的 MCP 聚合器，它将所有 RND-PRO 服务器组合在一个配置条目之后： ``` { "mcpServers": { "agent-portal": { "command": "npx", "args": ["-y", "mcp-agent-portal"] } } } ``` 也可以独立使用或与 [**agent-pool-mcp**](https://www.npmjs.com/package/agent-pool-mcp) 一起使用——多代理任务委派： ``` # 为两个服务器生成带有正确路径的配置： npx -y project-graph-mcp config npx -y agent-pool-mcp config # 或使用捆绑两者的 mcp-agent-portal。 ``` ## 文档 - [CONFIGURATION.md](CONFIGURATION.md) —— 所有支持 IDE 的设置 - [GUIDE.md](GUIDE.md) —— 包含所有工具的全面使用指南 - [ARCHITECTURE.md](ARCHITECTURE.md) —— 源代码结构 - [AGENT_ROLE.md](docs/examples/AGENT_ROLE.md) —— 完整系统提示词代理 - [ROADMAP.md](docs/ROADMAP.md) —— 功能路线图和待办事项列表 ## 相关项目 - [mcp-agent-portal](https://github.com/rnd-pro/mcp-agent-portal) —— 统一 MCP 聚合器 + 网络仪表板 + AI 代理运行时 - [agent-pool-mcp](https://github.com/rnd-pro/agent-pool-mcp) —— 通过 Gemini CLI 进行多代理编排 - [Symbiote.js](https://github.com/symbiotejs/symbiote.js) —— 同构响应式 Web 组件框架 - [JSDA-Kit](https://github.com/rnd-pro/jsda-kit) —— 现代网络应用程序的 SSG/SSR 工具包 ## 许可证 MIT © [RND-PRO.com](https://rnd-pro.com) **由 RND-PRO 团队用❤️制作**

标签：Acorn, GNU通用公共许可证, Go, MITM代理, Node.js, Python, Ruby工具, TypeScript, 人工智能, 代码上下文, 代码优化, 代码健康度, 代码分析, 代码分析工具, 代码压缩, 代码压缩工具, 代码压缩率, 代码审查, 代码库优化工具, 代码库分析工具, 代码库工具, 代码库数据库工具, 代码库文档工具, 代码库测试工具, 代码库测试清单工具, 代码库管理, 代码库管理工具, 代码库维护工具, 代码模式, 代码理解, 代码编辑, 代码解析, 代码质量工具, 代码重构, 凭证管理, 多语言支持, 安全插件, 安全测试框架, 数据可视化, 数据库分析, 文档生成, 无后门, 日志审计, 测试清单, 用户模式Hook绕过, 自定义脚本, 逆向工具, 项目图, 项目结构