JinDaGe - yellhorn-mcp MCP Details

article

README

🚀 Yellhorn MCP

Yellhorn MCP 是一个模型上下文协议 (MCP) 服务器，它提供了 Gemini 2.5 Pro 和 OpenAI 的功能。在软件开发任务中，该服务器可利用整个代码库上下文提示 Claude Code。这种模式非常适合定义由代码助手（如 Claude Code 或其他与 MCP 兼容的编码代理）执行的工作，并通过全面检查结果确保其符合原始要求。

✨ 主要特性

创建工作计划：依据提示生成详细的实施计划，此计划会充分考虑整个代码库，然后将其作为 GitHub 问题发布，同时以 MCP 资源形式暴露给编码代理。
评估代码差异：提供了一个工具，用于评估 Git 差异与 GitHub 问题中的工作计划是否一致，并在背景中创建子问题。
获取资源：实现了标准的 MCP 资源 API，可提供对工作计划的访问。
开发信息：包含了安装、配置、使用说明和测试指令。

📦 安装指南

# 安装生产依赖
pip install .

# 安装开发依赖
pip install -e ".[dev]"

📚 详细文档

配置

编辑配置文件：

# MCP配置示例
[mcp]
name = "Yellhorn-MCP"
version = "0.2.1"
description = "Yellhorn Model Context Protocol Server"
author = "your_name_here"
author_email = "your_email_here"
url = "https://github.com/your_account/yellhorn-mcp"

[server]
host = "localhost"
port = 8080
workers = 4

使用说明

💻 使用示例

基础用法

创建工作计划

# 创建新工作计划
mcp create-resource yellhorn-mcp --name "项目名称" --description "项目描述"

# 更新现有工作计划
mcp update-resource yellhorn-mcp 123 --description "更新后的描述"

评估代码差异

# 异步触发评估
mcp judge-resource yellhorn-mcp 123 main HEAD

# 查看评估结果
mcp get-resource-judgment yellhorn-mcp 123

高级用法

资源访问 Yellhorn MCP 实现了标准的 MCP 资源 API：

# 列出所有工作计划
mcp list-resources yellhorn-mcp

# 获取特定工作计划
mcp get-resource yellhorn-mcp 123

开发

# 安装开发依赖
pip install -e ".[dev]"

# 运行测试
pytest

# 生成覆盖率报告
pytest --cov=yellhorn_mcp --cov-report term-missing

CI/CD

项目使用 GitHub Actions 实现持续集成和交付：

测试：在拉动请求和推送到主分支时自动运行
- 使用 flake8 进行代码检查
- 使用 black 检查代码格式
- 使用 pytest 执行测试
发布：当带有版本标签的提交后自动部署到 PyPI
- 标签必须与 pyproject.toml 中的版本匹配（例如 v0.2.2）
- 需要存储在 GitHub 仓库秘密中的 PyPI API 令牌 (PYPI_API_TOKEN)

发布新版本

更新 pyproject.toml 和 yellhorn_mcp/__init__.py 中的版本
更新 CHANGELOG.md 添加变更日志
提交更改：git commit -m "Bump version to X.Y.Z"
打标签：git tag vX.Y.Z
推送更改和标签：git push && git push --tags

参考文档

使用指南：请参阅 USAGE.md
变更日志：查看 CHANGELOG.md

📄 许可证

MIT

yellhorn-mcp