JinDaGe - GitHub Projects MCP Details

article

README

🚀 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

手动安装

克隆此仓库：

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

安装依赖项：
```
bun install
```

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

GITHUB_TOKEN=your_github_personal_access_token
GITHUB_OWNER=your_github_username

构建服务器：
```
bun run build
```
配置您的 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_TOKEN | GitHub 个人访问令牌 | | GITHUB_OWNER | GitHub 用户名或组织名称 |

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 项目
管理项目字段、项和状态更新
将草稿问题转换为实际问题
存档和取消存档项目项

问题

获取问题详细信息
将问题添加到项目中

仓库

获取仓库信息

GitHub Projects