Github Projects V2

🚀 GitHub 項目 V2 MCP 服務器

GitHub 項目 V2 MCP 服務器是一個基於模型上下文協議（MCP）的服務器，它提供了一系列管理 GitHub 項目 V2 的工具。用戶可藉助 Claude 以及其他 MCP 客戶端來使用這些工具。此服務器藉助 GitHub GraphQL API 與 GitHub 項目 V2 進行交互。

✨ 主要特性

• 🔍 列出和查看用戶及其組織的 GitHub 項目 V2。
• 📋 獲取項目字段及項目中的條目（問題、拉取請求、草稿問題）。
• ➕ 創建問題並將它們添加到項目中。
• 📝 直接在項目中創建草稿問題。
• ✏️ 更新項目條目的字段值。
• ❌ 從項目中刪除條目。

🚀 快速開始

此服務器可以與任何 MCP 客戶端一起使用，例如 Claude Desktop。將其添加到您的 MCP 客戶端配置文件（例如 claude_desktop_config.json）中。

📦 安裝指南

方案 1：使用已發佈的包

以下是使用 uvx 命令運行器的示例配置：

{
  "mcpServers": {
    "github-projects": {
      "command": "uvx",
      "args": [
        "mcp-github-projects"
      ],
      "env": {
        "GITHUB_TOKEN": "your_pat_here"
      }
    }
  }
}

⚠️ 重要提示

請將 your_pat_here 替換為您的實際 GitHub 個人訪問令牌。

方案 2：從源代碼運行

要直接從源代碼運行該項目，請按照以下步驟操作：

環境搭建

1. 克隆倉庫：

git clone git@github.com:Arclio/github-projects-mcp.git
cd github-projects-mcp

2. 創建並激活虛擬環境：

uv venv
source venv/bin/activate

3. 安裝依賴項：

uv pip install -e .

4. 設置您的 GitHub 令牌為環境變量： 創建一個 GitHub 個人訪問令牌，並授予必要的權限：repo、project 和 read:org。 運行以下命令將令牌添加到 .env 文件中：

cp .env.example .env

然後在 .env 文件中添加以下內容：

export GITHUB_TOKEN=your_personal_access_token

從源代碼使用

當從源代碼使用時，請按如下方式配置您的 MCP 客戶端：

{
  "mcpServers": {
    "github-projects": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/github-projects-mcp",
        "run",
        "mcp-github-projects"
      ],
      "env": {
        "GITHUB_TOKEN": "your_pat_here"
      }
    }
  }
}

⚠️ 重要提示

請將 /path/to/github-projects-mcp 和 your_pat_here 替換為您的實際倉庫路徑和 GitHub 個人訪問令牌。

💻 使用示例

基礎用法

此服務器提供了一系列可用工具，以下是各工具的功能說明：

• list_projects：列出用戶或組織的 GitHub 項目 V2
• get_project_fields：獲取 GitHub 項目 V2 中可用的字段
• get_project_items：獲取項目中的條目（支持按狀態或自定義單選字段過濾）
• create_issue：創建新的 GitHub 問題
• add_issue_to_project：將現有 GitHub 問題添加到項目中
• create_draftIssue：直接在項目中創建草稿問題
• update_field：更新項目條目的字段值
• remove_item：從項目中刪除條目

📚 詳細文檔

⚠️ 重要提示

請確保您的 GitHub 賬戶具有必要的權限以執行上述操作，並且始終遵循 GitHub 的 API 使用政策。