Github Issues

🚀 GitHub MCP 服務器

本項目是一個基於 Model Context Protocol (MCP) 的服務器實現，它藉助 Cline 與 GitHub 問題進行交互，能有效管理 GitHub 倉庫中的問題。

🚀 快速開始

本項目是一個通過 Cline 與 GitHub 問題交互的 Model Context Protocol (MCP) 服務器實現。你可以按照以下步驟快速搭建並使用該服務器。

✨ 主要特性

• 可列出倉庫中的 GitHub 問題，便於統一查看和管理。
• 支持創建新的 GitHub 問題，操作便捷。
• 具備完善的錯誤處理和驗證機制，保障系統穩定運行。
• 通過環境變量實現安全認證，提升系統安全性。

📦 安裝指南

克隆倉庫

git clone https://github.com/timbuchinger/mcp-github.git
cd mcp-github

安裝依賴

pip install uv
uv venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate
uv pip install -r requirements.txt

配置環境變量

cp .env.template .env

編輯 .env 文件並在其中添加你的 GitHub 個人訪問令牌：

GITHUB_TOKEN=your_token_here

創建 GitHub 個人訪問令牌的方法：

1. 轉到 GitHub 設置 -> 開發者設置 -> 個人訪問令牌。
2. 使用 repo 權限生成新的令牌。
3. 複製令牌並將其粘貼到你的 .env 文件中。

💻 使用示例

運行 MCP 服務器

python -m src.mcp_github.server

該服務器將向 Cline 暴露兩個工具：

基礎用法

get_issues

從 GitHub 倉庫獲取問題列表：

{
  "repo": "owner/repo"
}

create_issue

在 GitHub 倉庫創建新問題：

{
  "repo": "owner/repo",
  "title": "問題標題",
  "body": "問題描述"
}

🔧 技術細節

錯誤處理

服務器處理常見錯誤：

• 缺少 GitHub 令牌
• 無效的倉庫名稱
• 必要參數缺失
• GitHub API 錯誤

錯誤響應包含描述性消息，以幫助排查問題。

開發

該項目使用 uv 進行依賴管理。要設置開發環境：

# 安裝所有依賴（包括開發依賴）
uv pip install -r requirements.txt

# 運行測試
pytest

# 格式化代碼
black .

# 類型檢查
mypy .