🚀 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 项目
- 管理项目字段、项和状态更新
- 将草稿问题转换为实际问题
- 存档和取消存档项目项
问题
- 获取问题详细信息
- 将问题添加到项目中
仓库
- 获取仓库信息