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

问题

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

仓库

• 获取仓库信息