基本能力
产品定位
GitHub Project Manager MCP Server 是一个用于管理 GitHub 项目的服务,通过 MCP 协议提供标准化的工具和资源,使 LLM 客户端能够以编程方式管理 GitHub 项目。
核心功能
- 项目管理
- 创建和管理 GitHub Projects (v2)
- 处理项目设置和配置
-
管理项目可见性和访问权限
-
项目资源管理
- 问题和里程碑管理
- 冲刺规划和跟踪
- 自定义字段和视图
-
资源版本控制和锁定
-
MCP 实现
- 完全符合 MCP 规范
- 标准化工具定义
- 资源状态管理
- 渐进式响应处理
-
全面的错误处理
-
GitHub 集成
- GraphQL API 集成
- 速率限制处理
- 乐观并发控制
- Webhook 支持(计划中)
适用场景
- 团队协作项目管理
- 开发流程中的冲刺规划和跟踪
- 问题和里程碑管理
- 自定义字段和视图配置
工具列表
- 项目管理工具:用于创建和管理 GitHub 项目。
- 里程碑管理工具:用于管理项目中的里程碑。
- 冲刺规划工具:用于规划和跟踪冲刺进度。
- 问题管理工具:用于管理项目中的问题。
常见问题解答
- 如何获取 GitHub Token?:需要在 GitHub 设置中生成具有
repo
、project
和write:org
权限的 Token。 - 如何配置环境变量?:复制
.env.example
到.env
并填写相应的 GitHub Token 和仓库信息。
使用教程
使用依赖
```bash
安装依赖
npm install
或
pnpm install
```
安装教程
```bash
设置环境变量
cp .env.example .env
编辑 .env 文件,填写 GitHub Token 和仓库信息
```
调试方式
```bash
启动 MCP 服务器
npm start
运行测试
npm test
npm run test:e2e
```