GitHub 项目管理助手
enables users to interact with GitHub's Projects v2 API through natural language for Agile project management, supporting repository details, issue tracking, and project board management operations. 翻译：通过自然语言启用用户与GitHub的Projects v2 API进行交互，用于敏捷项目管理，支持仓库详情、问题跟踪和项目看板管理操作。
可用工具 （31 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
get-repository 2 个参数 需填 2 项
Get a GitHub repository by owner and name
必填参数：owner、repo
list-repositories 6 个参数 需填 1 项
List repositories for a user
必填参数：owner
get-project 1 个参数 需填 1 项
Get a GitHub Project by ID
必填参数：projectId
list-projects 3 个参数 需填 1 项
List GitHub Projects for a user
必填参数：owner
get-project-columns 1 个参数 需填 1 项
Get status columns for a GitHub Project
必填参数：projectId
get-project-fields 1 个参数 需填 1 项
Get fields for a GitHub Project
必填参数：projectId
get-project-items 4 个参数 需填 1 项
Get items (issues) from a GitHub Project
必填参数：projectId
create-project-item 3 个参数 需填 2 项
Add an issue or PR to a GitHub Project
必填参数：projectId、contentId
update-project-item-field 4 个参数 需填 4 项
Update a field value for a project item
必填参数：projectId、itemId、fieldId、value
create-project 4 个参数 需填 2 项
Create a new GitHub Project
必填参数：ownerId、title
update-project 6 个参数 需填 1 项
Update an existing GitHub Project
必填参数：projectId
delete-project 1 个参数 需填 1 项
Delete a GitHub Project
必填参数：projectId
copy-project 5 个参数 需填 2 项
Copy a GitHub Project
必填参数：projectId、ownerId
add-draft-issue 4 个参数 需填 2 项
Add a draft issue to a GitHub Project
必填参数：projectId、title
convert-draft-issue 5 个参数 需填 3 项
Convert a draft issue to a regular issue
必填参数：projectId、draftIssueId、repositoryId
add-item-to-project 2 个参数 需填 2 项
Add an existing issue or PR to a GitHub Project
必填参数：projectId、contentId
update-item-position 3 个参数 需填 2 项
Update the position of an item in a GitHub Project
必填参数：projectId、itemId
delete-project-item 2 个参数 需填 2 项
Remove an item from a GitHub Project
必填参数：projectId、itemId
create-project-field 4 个参数 需填 3 项
Create a new field in a GitHub Project
必填参数：projectId、dataType、name
update-project-field 5 个参数 需填 2 项
Update a field in a GitHub Project
必填参数：projectId、fieldId
delete-project-field 2 个参数 需填 2 项
Delete a field from a GitHub Project
必填参数：projectId、fieldId
update-project-status 3 个参数 需填 2 项
Update the status of a GitHub Project
必填参数：projectId、text
archive-project-item 2 个参数 需填 2 项
Archive an item in a GitHub Project
必填参数：projectId、itemId
unarchive-project-item 2 个参数 需填 2 项
Unarchive an item in a GitHub Project
必填参数：projectId、itemId
clear-item-field-value 3 个参数 需填 3 项
Clear a field value for an item in a GitHub Project
必填参数：projectId、itemId、fieldId
mark-project-as-template 1 个参数 需填 1 项
Mark a GitHub Project as a template
必填参数：projectId
unmark-project-as-template 1 个参数 需填 1 项
Unmark a GitHub Project as a template
必填参数：projectId
get-issue 3 个参数 需填 3 项
Get a GitHub issue by number
必填参数：owner、repo、issueNumber
list-issues 10 个参数 需填 2 项
List issues for a repository
必填参数：owner、repo
create-issue 7 个参数 需填 3 项
Create a new GitHub issue
必填参数：owner、repo、title
update-issue 9 个参数 需填 3 项
Update an existing GitHub issue
必填参数：owner、repo、issueNumber
服务介绍
GitHub Projects MCP 服务器
这是一个 MCP（Model Context Protocol）服务器，它使 AI 代理能够使用 GitHub Projects 创建和管理基于敏捷冲刺的项目。
特性
- GitHub Projects v2 API：完全支持 GitHub 的 GraphQL Projects v2 API
- GitHub Issues：创建、读取和更新 GitHub 问题
- GitHub Repositories：获取仓库详细信息
- 类型安全：使用 TypeScript 构建，以实现最大化的类型安全
安装
通过 Smithery 安装
要通过 Smithery 自动为 Claude Desktop 安装 GitHub Projects MCP 服务器：
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 项目
- 管理项目字段、条目和状态更新
- 将草稿问题转换为实际问题
- 归档和取消归档项目条目
问题
- 获取问题详情
- 将问题添加到项目中
仓库
- 获取仓库信息
