GitHub 项目 MCP 服务器

MCP（模型上下文协议）服务器，使 AI 代理能够使用 GitHub 项目创建和管理基于 Agile Sprint 的项目。

特征

• GitHub Projects v2 API ：全面支持 GitHub 的 GraphQL Projects v2 API

• GitHub 问题：创建、阅读和更新 GitHub 问题

• GitHub 存储库：获取存储库详细信息

• 类型安全：使用 TypeScript 构建，以实现最大程度的类型安全

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 GitHub Projects MCP Server：

用法

手动安装

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 客户端：

环境变量

• 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 服务器，专注于项目 V2 的操作。代码库通过 GraphQL 提供对 GitHub 项目功能的类型化访问。

可用操作

项目

• 创建、读取、更新和删除 GitHub 项目

• 管理项目字段、项目和状态更新

• 将草稿问题转换为实际问题

• 存档和取消存档项目

问题

• 获取问题详细信息

• 将问题添加到项目

存储库

• 获取存储库信息