MCP构建服务
一种模型上下文协议（MCP）服务器，提供对git存储库的访问，用于构建和测试操作。这允许AI助手代表您运行构建、执行测试和检查git存储库。
它有什么作用？
该服务为人工智能助手提供工具，以：
- 列出可用的git存储库
- 执行git命令（状态、日志、签出、拉取、获取、差异、显示、分支）
- 运行make目标（构建、测试、清理等）
- 列出目录内容
- 从存储库读取文件
- 查询已安装的构建工具和版本
该服务在包含git存储库的目录中运行，并通过MCP协议公开它们。
用例
典型的工作流程是：
- 您在工作区中开发代码并推送到git分支
- AI助手使用此服务在构建环境中结账您的分行
- AI助手在该分支上运行构建和测试
- AI助手向您报告结果
- 您根据反馈进行修复并重复
这将您的开发环境与AI使用的构建/测试环境分开。
安装
git clone
cd mcp-build
pip install -e .设置
创建或指定一个包含git存储库的目录：
/path/to/build-area/
├── project-one/ # git repository
├── project-two/ # git repository
└── project-three/ # git repository用法
本地模式（stdio）
在包含存储库的目录中启动服务：
cd /path/to/build-area
mcp-build配置Claude Desktop以使用它。添加到您的Claude Desktop配置文件中：
macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"build": {
"command": "mcp-build",
"cwd": "/path/to/build-area"
}
}
}远程模式（HTTP）
从HTTP传输开始：
cd /path/to/build-area
mcp-build --transport http --host 0.0.0.0 --port 3344该服务在启动时生成会话密钥。使用以下配置Claude Desktop：
{
"mcpServers": {
"build": {
"url": "http://your-server:3344/sse?key=SESSION_KEY"
}
}
}命令行选项
mcp-build --help # Show all options
mcp-build # stdio mode (default)
mcp-build --transport http # HTTP mode, auto-generate session key
mcp-build --transport http --session-key YOUR_KEY
mcp-build --transport http --host 0.0.0.0 --port 8080可用工具
该服务公开了这些MCP工具：
- 列表 -列出可用存储库
- 版本控制系统 -执行git命令（仅限于：status、log、checkout、pull、branch、diff、fetch、show）
- 制造 -使用指定参数运行make（执行Makefile中的任何内容）
- ls -列出文件和目录
- 环境 -显示已安装的工具和版本
- read_file -读取文件内容（大文件可选行范围）
安全注意事项
Git操作： 该服务将git命令限制在白名单中（状态、日志、签出、拉取、分支、差异、获取、显示）。危险操作，如 git push --force 或 git reset --hard 被封锁。
命令验证： 该服务阻止路径遍历模式(../)以及一些命令注入模式（管道、重定向、命令替换）。
制定目标： 该服务运行您指定的任何目标。这些执行存储库的Makefile中定义的命令，Makefile可以是任何东西。该服务不会对Makefiles的功能进行沙盒或限制。
身份验证（HTTP模式）： 需要将会话密钥作为承载令牌或查询参数传递。密钥可以自动生成或提供。
建议： 在适合构建操作的环境中运行此服务（例如，专用构建VM、容器或CI环境）。它验证了一些输入，但不提供全面的沙盒。
AI助手使用示例
配置后，您可以询问您的AI助手：
- “列出可用存储库”
- “检查我项目中的功能分支并运行make test”
- “main上最新提交的构建输出是什么？”
- “显示主分支和功能分支之间的区别”
AI将通过MCP工具调用自动使用该服务。
故障排除
未找到存储库
- 验证您是否在git repos的父目录中启动了mcp构建
- 检查每个目录是否有
.git子目录
未找到存储库
- 存储库名称必须与目录名称完全匹配
- 使用列表工具查看可用名称
构建失败
- 使用env工具检查已安装的构建工具
- 验证Makefile是否存在，以及是否具有您尝试运行的目标
连接问题（HTTP模式）
- 检查会话密钥是否与启动时打印的服务相匹配
- 验证防火墙是否允许该端口
- 卷曲测试：
curl -H "Authorization: Bearer KEY" http://host:port/api/repos
HTTP API
除了MCP协议，该服务还提供HTTP端点：
快速操作（REST）：
GET /api/repos-列出存储库GET /api/repos/{repo}/env-环境信息POST /api/repos/{repo}/ls-列出文件POST /api/repos/{repo}/read_file-读取文件内容POST /api/repos/{repo}/git/quick-快速git操作（状态、分支、日志）
长时间操作（流式SSE）：
POST /stream/repos/{repo}/make-流构建输出POST /stream/repos/{repo}/git-流git操作（pull、fetch、diff、show、checkout）
所有端点都需要通过会话密钥进行身份验证。
发展
运行测试：
pip install -e ".[dev]"
pytest tests/项目结构：
mcp-build/
├── src/
│ ├── server.py # Main server
│ └── validators.py # Input validation
├── tests/ # Tests
├── README.md # This file (user docs)
└── MCP-BUILD.md # Agent usage guide许可证
MIT许可证