Yellhorn MCP

基本能力

产品定位

Yellhorn MCP 是一个专注于软件开发辅助的工具，通过集成 Gemini 2.5 Pro 的能力，为开发者提供自动化的工作计划生成、代码审查和 GitHub 集成等功能。

核心功能

• 工作计划生成：根据代码库生成详细的 GitHub 问题（issues），包含自定义标题和详细描述。
• 隔离开发环境：自动创建 Git worktree 和关联的分支，支持隔离的开发流程。
• 代码审查：评估 Pull Request 是否符合原始工作计划，并提供详细反馈。
• GitHub 集成：自动创建带标签的问题，并在 GitHub UI 中链接分支，将审查结果作为 PR 评论发布。
• 上下文控制：通过 .yellhornignore 文件排除特定文件和目录，避免干扰 AI 上下文。
• MCP 资源：将工作计划作为标准 MCP 资源提供，便于列表和检索。

适用场景

• 团队协作开发：自动化生成工作计划和代码审查，提升团队协作效率。
• 个人开发：通过隔离的开发环境和自动化工具，简化个人开发流程。
• 开源项目维护：快速生成问题并管理 Pull Request，适用于开源项目的维护。

工具列表

1. generate_workplan：生成 GitHub 问题并创建 Git worktree。
2. 输入：标题和详细描述。
3. 输出：问题 URL 和 worktree 路径。
4. get_workplan：检索工作计划内容。
5. 输入：可选问题编号（在非 worktree 目录中运行时需要）。
6. 输出：工作计划内容。
7. review_workplan：触发异步代码审查。
8. 输入：PR URL 和可选问题编号。
9. 输出：确认消息。

常见问题解答

• 依赖问题：需要安装 GitHub CLI (gh) 并完成认证。
• 环境变量：必须设置 GEMINI_API_KEY 和 REPO_PATH。
• 模型选择：默认使用 gemini-2.5-pro-exp-03-25，可通过环境变量修改。

使用教程

使用依赖

1. 安装 GitHub CLI (gh) 并完成认证。 bash # 安装 GitHub CLI brew install gh # 认证 gh auth login

安装教程

1. 从 PyPI 安装： bash pip install yellhorn-mcp
2. 从源码安装： bash git clone https://github.com/msnidal/yellhorn-mcp.git cd yellhorn-mcp pip install -e .

调试方式

1. 运行服务器： bash yellhorn-mcp --repo-path /path/to/repo --host 127.0.0.1 --port 8000
2. 使用 MCP CLI： bash mcp dev yellhorn_mcp.server
3. 安装为永久 MCP 服务器： bash mcp install yellhorn_mcp.server

许可证

该项目遵循 MIT 开源许可条款。