🚀 Booster MCP——大型代码库的语义代码智能
  
🎯 所得
Booster MCP将复杂的代码库转化为可理解的系统。
你花更少的时间搜索，花更多的时间构建。而不是：
- ❌ 手动抓取数千个文件
- ❌ 迷失在陌生的架构中
- ❌ 通过猜测进行调试
你得到：
- ✅ 即时语义理解 --在整个代码库中提问并获得答案
- ✅ 可视化架构图 --将您的代码视为3D“代码城市”
- ✅ 自动上下文注入 --准确包括人工智能修复错误或添加功能所需的内容
- ✅ 调试超能力 --挂纸白板会话，包括调用图、序列图和会话笔记
- ✅ 7种久经考验的特工技能 --用于入职、重构、bug查找和代码审查的预构建工作流
现实世界影响
| 问题 | 旧方法 | 使用助推器 |
|---|---|---|
| 新开发人员入职 | 2-3天grep | 30分钟交互式地图+上下文 |
| 查找相关代码 | 手动搜索 | 语义搜索+符号图 |
| 调试生产问题 | 堆栈跟踪→ 手动追踪 | analyze_error() → 调用图→ fix |
| 代码审查瓶颈 | 人工审查时间 | 语义+依赖性分析 |
______________________________________________________________________
⚡ 快速入门（1分钟）
一键安装
macOS/Linux：
curl -fsSL https://raw.githubusercontent.com/NeuroGhostDev/Booster-mcp/main/install.sh | bashWindows（PowerShell）：
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/NeuroGhostDev/Booster-mcp/main/install.ps1" -OutFile "install.ps1" | .\install.ps1第一个命令
add_repo("C:\\my-project")
get_code_city() # Opens 3D visualization in browser就是这样。你的代码库现在可以通过人工智能进行搜索。
______________________________________________________________________
💎 功能概览
🔍 语义搜索 （不仅仅是Grep）
- 矢量驱动的代码搜索理解意图，而不仅仅是关键字
- 查找“身份验证流”并获取相关登录、OAuth、令牌验证码
- 跨多种语言工作
🗺️ 代码城市3D
- 项目结构的可视化表示
- 建筑物=文件（高度=复杂性，颜色=语言）
- 立即发现架构模式和依赖关系
📊 存储库映射
- 入职培训的单页项目概述
- 自动生成，始终同步
- 包括约定、堆栈和模块边界
🐛 挂图调试
- 使用调用图和序列图创建调试会话
- 美人鱼驱动的可视化
- 添加注释并跨符号跟踪假设
🤖 7内置代理技能
booster-onboard--新代码库？从这里开始booster-context-inject--为AI提供它所需要的东西booster-bug-hunt--堆栈跟踪→ 诊断→ fixbooster-feature-add--查找模式，添加一致的代码booster-deep-dive--理解架构booster-refactor--影响分析+变更自动化booster-review--语义代码审查
🔗 上下文注入
repo://map → Repository structure
repo://stack → Dependencies and frameworks
repo://conventions → Code patterns and standards通过以下方式与实时文档自动同步 fetch_stack_docs().
⚙️ 增量索引
- 监视器监视更改
- 无需手动重新索引
- 无需重新启动服务器即可支持多仓库
______________________________________________________________________
📦 包含什么
| 组件 | 目的 |
|---|---|
| FastMCP服务器 | 核心工具定义和布线 |
| 矢量索引器 | FAISS支持的跨代码语义搜索 |
| 图形引擎 | 调用图、导入图、依赖关系分析 |
| 代码城市可视化工具 | 代码库的3D HTML可视化 |
| 代理技能 | 7个用于常见任务的预构建工作流 |
| 网页用户界面 | 管理仓库、生成可视化、检查地图 |
| 翻页图表 | 使用Mermaid图调试会话 |
| 工具包 | Grep、git、命令执行、错误分析 |
______________________________________________________________________
🛠️ 安装
需求
- Python 3.11+
- Git
- 互联网（首次运行下载嵌入模型）
完全手动安装（所有平台）
克隆和设置：
git clone https://github.com/NeuroGhostDev/Booster-mcp.git
cd Booster-mcp
python3.11 -m venv .venv
source .venv/bin/activate # or .\.venv\Scripts\Activate.ps1 on Windows
pip install -r requirements.txt开始：
python server.py配置您的MCP客户端
添加到您的 .claude_desktop_config.json （克劳德桌面、克莱恩等）：
macOS/Linux：
{
"mcpServers": {
"Booster": {
"command": "/home/user/Booster-mcp/.venv/bin/python",
"args": ["/home/user/Booster-mcp/server.py"]
}
}
}Windows（使用绝对路径）：
{
"mcpServers": {
"Booster": {
"command": "C:\\Users\\YourName\\Booster-mcp\\.venv\\Scripts\\python.exe",
"args": ["C:\\Users\\YourName\\Booster-mcp\\server.py"]
}
}
}______________________________________________________________________
🚀 常见工作流
启动一个新项目
add_repo("C:\\project")
repo_stats() # Quick metrics
get_repo_map() # Architecture overview
semantic_search("main entry point")
find_symbol("main") # Navigate to key functions调试生产错误
analyze_error("TypeError: 'NoneType' object is not subscriptable")
flipchart_quick_debug("handler_function", max_depth=3)
read_with_context("auth.py", line=42, context=10)
git_diff("auth.py") # See recent changes安全地添加功能
semantic_search("similar feature pattern")
find_symbol("existing_feature")
flipchart_sequence_diagram("existing_feature", depth=5)
# Now safe to implement超级大国代码审查
flipchart_call_graph("modified_function", max_depth=5)
external_deps("modified_function")
find_duplicates(min_lines=5)______________________________________________________________________
📚 全部文件
- COOKBOOK.md --深潜食谱和高级用法
- 市场.md --发布到MCP目录
______________________________________________________________________
🎓 最大功率系统说明
将此添加到您的MCP客户端以获得最佳结果：
MCP Usage Policy:
- New codebase? Use onboard skill first
- Production error? Use bug-hunt skill
- Architecture question? Use deep-dive skill
- Adding feature? Use feature-add skill + inject context
- Refactoring? Use refactor skill + analyze impact
- Code review? Use review skill + semantic analysis
Always prefer semantic tools over grep for understanding.\[请参阅README中的完整系统说明\]
______________________________________________________________________
🛠️ 所有可用工具
库管理
add_repo(path)--为新存储库建立索引remove_repo(path)--停止跟踪reindex_repo(path)--强制重新索引list_repos()--查看活动存储库repo_stats()--尺寸、符号、度量
搜索和导航
semantic_search(query)--按含义查找代码find_symbol(name)--查找函数、类
上下文注入
inject_context()--自动构建AI上下文fetch_stack_docs()--实时依赖文档
调试
flipchart_quick_debug(symbol)--即时图表flipchart_call_graph(symbol)--显示来电者/被叫者flipchart_sequence_diagram(symbol)--流程图analyze_error(stacktrace)--误差分析
公用事业
code_grep(pattern)--智能grepread_with_context(file, line)--显示代码+上下文git_log(path)--查看历史run_command(cmd)--执行工具find_duplicates()--代码重复external_deps(symbol)--查看依赖关系
可视化
get_code_city()--三维可视化get_repo_map()--建筑图
______________________________________________________________________
🌍 语言支持
- python
- JavaScript/TypeScript
- 锈
- 去
- Java
- C/C++
______________________________________________________________________
🧪 测试
python test_mcp.py # Basic tests
python test_all.py # Full suite______________________________________________________________________
❓ 常见问题解答
Q： 这会减慢我的代码库吗？\ A： 不，索引是单独的。你的代码正常运行。
Q： 它适用于私有仓库吗？\ A： 是的。一切都在本地运行。没有数据离开你的机器。
Q： 支持哪些AI客户端？\ A： 任何兼容MCP的客户端（Claude Desktop、Cline、Continue等）。
Q： 我可以一次索引多个仓库吗？\ A： 是的。 add_repo() 你想要多少就多少。无需重新启动。
Q： 如果我的回购是1M+行怎么办？\ A： 工作得很好。语义索引是为规模而构建的。使用 .ignore 跳过繁重的目录。
______________________________________________________________________
📖 详细文档和指南
- COOKBOOK.md --食谱、示例、先进技术
- 市场.md --发布到Smithery，Glama
______________________________________________________________________
🤝 贡献
- 叉起来
- 分行：
git checkout -b feature/my-feature - 承诺：
git commit -m "Add feature" - 测试：
python test_all.py - 推送并打开PR
______________________________________________________________________
📄 许可证
麻省理工学院——自由使用，无论是商业用途还是其他用途。
______________________________________________________________________
🎯 后续步骤
- 立即安装： 运行一键式安装程序
- 试试看：
add_repo()+get_code_city() - 阅读食谱： 高级工作流程和示例
- 分享反馈：
______________________________________________________________________
专为对工具有更高要求的开发人员而设计。 ⚡