GitHub Projects MCP Server
使用户能够通过自然语言与 GitHub 的 Projects v2 API 交互,以进行敏捷项目管理,支持仓库详情、问题跟踪和项目看板管理操作。
Tools
create-issue
Create a new GitHub issue
update-issue
Update an existing GitHub issue
get-repository
Get a GitHub repository by owner and name
list-repositories
List repositories for a user
get-project
Get a GitHub Project by ID
list-projects
List GitHub Projects for a user
get-project-columns
Get status columns for a GitHub Project
get-project-fields
Get fields for a GitHub Project
get-project-items
Get items (issues) from a GitHub Project
create-project-item
Add an issue or PR to a GitHub Project
update-project-item-field
Update a field value for a project item
create-project
Create a new GitHub Project
update-project
Update an existing GitHub Project
delete-project
Delete a GitHub Project
copy-project
Copy a GitHub Project
add-draft-issue
Add a draft issue to a GitHub Project
convert-draft-issue
Convert a draft issue to a regular issue
add-item-to-project
Add an existing issue or PR to a GitHub Project
update-item-position
Update the position of an item in a GitHub Project
delete-project-item
Remove an item from a GitHub Project
create-project-field
Create a new field in a GitHub Project
update-project-field
Update a field in a GitHub Project
delete-project-field
Delete a field from a GitHub Project
update-project-status
Update the status of a GitHub Project
archive-project-item
Archive an item in a GitHub Project
unarchive-project-item
Unarchive an item in a GitHub Project
clear-item-field-value
Clear a field value for an item in a GitHub Project
mark-project-as-template
Mark a GitHub Project as a template
unmark-project-as-template
Unmark a GitHub Project as a template
get-issue
Get a GitHub issue by number
list-issues
List issues for a repository
README
GitHub Projects MCP 服务器
一个 MCP (模型上下文协议) 服务器,使 AI 代理能够使用 GitHub Projects 创建和管理基于 Agile Sprint 的项目。
<a href="https://glama.ai/mcp/servers/86aw338aa5"> <img width="380" height="200" src="https://glama.ai/mcp/servers/86aw338aa5/badge" alt="GitHub Projects Server MCP server" /> </a>
特性
- GitHub Projects v2 API: 完全支持 GitHub 的 GraphQL Projects v2 API
- GitHub Issues: 创建、读取和更新 GitHub issues
- 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 Personal Access TokenGITHUB_OWNER: GitHub 用户名或组织名称
GitHub 令牌权限
此 MCP 服务器需要一个具有以下权限的 GitHub Personal Access Token (classic):
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 项目
- 管理项目字段、项目和状态更新
- 将草稿 issue 转换为实际 issue
- 存档和取消存档项目
Issues
- 获取 issue 详情
- 将 issue 添加到项目
仓库
- 获取仓库信息
推荐服务器
Playwright MCP Server
一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。
Magic Component Platform (MCP)
一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。
@kazuph/mcp-taskmanager
用于任务管理的模型上下文协议服务器。它允许 Claude Desktop(或任何 MCP 客户端)在基于队列的系统中管理和执行任务。
Gitingest-MCP
一个用于 gitingest 的 MCP 服务器。它允许像 Claude Desktop、Cursor、Cline 等 MCP 客户端快速提取关于 Github 仓库的信息,包括仓库摘要、项目目录结构、文件内容等。
MCP Package Docs Server
促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档,通过多语言支持和性能优化来增强软件开发。
Claude Code MCP
一个实现了 Claude Code 作为模型上下文协议(Model Context Protocol, MCP)服务器的方案,它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力(代码生成、编辑、审查和文件操作)。
Linear MCP Server
一个模型上下文协议(Model Context Protocol)服务器,它与 Linear 的问题跟踪系统集成,允许大型语言模型(LLM)通过自然语言交互来创建、更新、搜索和评论 Linear 问题。
Sequential Thinking MCP Server
这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决,支持修订,并通过完整的 MCP 集成来实现多条解决方案路径。
mermaid-mcp-server
一个模型上下文协议 (MCP) 服务器,用于将 Mermaid 图表转换为 PNG 图像。
Jira-Context-MCP
MCP 服务器向 AI 编码助手(如 Cursor)提供 Jira 工单信息。