基本能力
产品定位
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 安装
bash
npx -y @smithery/cli install taylor-lindores-reeves/mcp-github-projects --client claude
手动安装
-
克隆仓库
bash
git clone https://github.com/taylor-lindores-reeves/mcp-github-projects.git
cd mcp-github-projects -
安装依赖
bash
bun install -
创建
.env
文件
GITHUB_TOKEN=your_github_personal_access_token
GITHUB_OWNER=your_github_username -
构建服务器
bash
bun run build -
配置 MCP 客户端
json
{
"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