Github Projects

🚀 GitHub 項目 MCP 服務器

一個 MCP（模型上下文協議）服務器，它能讓 AI 代理創建並管理基於敏捷 Sprint 的 GitHub 項目，為開發者在項目管理方面提供了強大支持。

✨ 主要特性

• GitHub 項目 v2 API：全面支持 GitHub 的 GraphQL 項目 v2 API，為項目管理提供強大的接口能力。
• GitHub 問題：可創建、讀取和更新 GitHub 問題，方便對項目中的問題進行跟蹤和處理。
• GitHub 倉庫：能夠獲取倉庫詳細信息，幫助開發者更好地瞭解倉庫情況。
• 類型安全：使用 TypeScript 實現最大類型安全，提高代碼的可靠性和可維護性。

📦 安裝指南

使用 Smithery 安裝

通過 Smithery 可自動安裝 GitHub 項目 MCP 服務器以用於 Claude Desktop，執行以下命令：

npx -y @smithery/cli install taylor-lindores-reeves/mcp-github-projects --client claude

手動安裝

1. 克隆此倉庫：

   git clone https://github.com/taylor-lindores-reeves/mcp-github-projects.git
   cd mcp-github-projects
   

2. 安裝依賴項：

   bun install
   

3. 創建包含 GitHub 令牌的 .env 文件：

   GITHUB_TOKEN=your_github_personal_access_token
   GITHUB_OWNER=your_github_username
   

4. 構建服務器：

   bun run build
   

5. 配置您的 MCP 客戶端使用以下設置：

{
  "mcpServers": {
    "GitHubProjects": {
      "command": "bun",
      "args": [
        "/path/to/your/directory/mcp-github-projects-main/build/index.js"
      ],
      "env": {
        "GITHUB_TOKEN": "your_github_personal_access_token",
        "GITHUB_OWNER": "your_github_username_or_org"
      }
    }
  }
}

🔧 技術細節

環境變量

GitHub 令牌權限

此 MCP 服務器需要一個具有以下權限的 GitHub 個人訪問令牌（經典版）：

• project - 對項目的完全控制
• read:project - 讀取項目信息
• repo - 對私有倉庫的完全控制
• repo:status - 訪問提交狀態
• repo_deployment - 訪問部署狀態
• public_repo - 訪問公共倉庫
• repo:invite - 訪問倉庫邀請
• security_events - 讀取和寫入安全事件

開發命令

• 構建：bun run build
• 生成 GraphQL 類型：bun run graphql-codegen

項目結構

這是一個針對 GitHub GraphQL API 的 MCP 服務器，專注於 Project V2 操作。該代碼庫通過 GraphQL 提供了對 GitHub 項目的有類型訪問。

可用操作

項目

• 創建、讀取、更新和刪除 GitHub 項目
• 管理項目字段、項和狀態更新
• 將草稿問題轉換為實際問題
• 存檔和取消存檔項目項

問題

• 獲取問題詳細信息
• 將問題添加到項目中

倉庫

• 獲取倉庫信息