Yellhorn MCP

🚀 Yellhorn MCP

Yellhorn MCP 是一個模型上下文協議 (MCP) 服務器，它集成了 Gemini 2.5 Pro 和 OpenAI 的功能。在軟件開發任務裡，它能利用整個代碼庫上下文來提示 Claude Code。這種模式可精準定義代碼助手（如 Claude Code 或其他兼容 MCP 的編碼代理）的工作，並通過全面檢查結果確保其符合原始要求。

🚀 快速開始

Yellhorn MCP 提供了一系列強大的功能，可幫助開發者更高效地進行軟件開發。以下是快速開始使用 Yellhorn MCP 的步驟：

1. 按照安裝指南完成安裝。
2. 根據配置說明編輯配置文件。
3. 參考使用說明，利用工具創建工作計劃、評估代碼差異等。
4. 通過資源訪問 API 對工作計劃進行管理。

✨ 主要特性

• 創建工作計劃：依據提示生成詳細的實施計劃，充分考慮整個代碼庫。將計劃作為 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)。

發佈新版本

1. 更新 pyproject.toml 和 yellhorn_mcp/__init__.py 中的版本。
2. 更新 CHANGELOG.md 添加變更日誌。
3. 提交更改：git commit -m "Bump version to X.Y.Z"。
4. 打標籤：git tag vX.Y.Z。
5. 推送更改和標籤：git push && git push --tags。

參考文檔

• 使用指南：請參閱 USAGE.md。
• 變更日誌：查看 CHANGELOG.md。

📄 許可證

本項目採用 MIT 許可證。