GitHub Projects MCP Server
2025.03.23
5
TypeScript项目管理GitHub 集成敏捷开发开发效率交流协作
GitHub Projects MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，旨在帮助 AI 代理通过 GitHub Projects v2 API 创建和管理基于敏捷冲刺（Agile Sprint）的项目。该服务提供了对 GitHub 项目的全面支持，包括创建、读取、更新和删除项目，管理项目字段、项目和状态更新，以及将草稿问题转换为实际问题等功能。
View on GitHub
Overview
基本能力
产品定位
GitHub Projects MCP Server 是一个专门为 AI 代理设计的服务，用于通过 GitHub Projects v2 API 进行项目管理和协作。
核心功能
- GitHub Projects v2 API: 全面支持 GitHub 的 GraphQL Projects v2 API
- GitHub Issues: 创建、读取和更新 GitHub 问题
- GitHub Repositories: 获取仓库详情
- 类型安全: 使用 TypeScript 构建，确保最大程度的类型安全
适用场景
- AI 代理管理 GitHub 项目
- 自动化敏捷冲刺（Agile Sprint）项目管理
- 团队协作和项目管理自动化
工具列表
- GitHub Projects v2 API: 用于项目管理的核心工具
- GitHub Issues: 用于问题跟踪和管理
- GitHub Repositories: 用于获取仓库信息
常见问题解答
- GitHub Token 权限: 需要具有
project,read:project,repo,repo:status,repo_deployment,public_repo,repo:invite,security_events权限的 GitHub Personal Access Token
使用教程
使用依赖
- 需要安装
bun运行时环境
安装教程
通过 Smithery 安装
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
- 创建
.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"
}
}
}
}
调试方式
- 构建:
bun run build - 生成 GraphQL 类型:
bun run graphql-codegen