Github Projects Mcp Server
@Arclio
关于 Github Projects Mcp Server
A Model Context Protocol (MCP) server that provides tools for managing GitHub Projects V2. This server uses the GitHub GraphQL API for interacting with GitHub Projects V2 for project board management and tracking tickets/issues.
基本信息
配置
使用下面的配置,将此服务器添加到你的 MCP 客户端。
{
"mcpServers": {
"github-projects": {
"command": "uvx",
"args": [
"mcp-github-projects"
],
"env": {
"GITHUB_TOKEN": "TOKEN"
}
}
}
}工具
8List GitHub Projects V2 for a given organization or user. Args: owner: The GitHub organization or user name Returns: A formatted string with project details
Get fields available in a GitHub Project V2, including options for SingleSelect fields. Args: owner: The GitHub organization or user name project_number: The project number Returns: A formatted string with field details.
Get items in a GitHub Project V2. Can filter by state OR a single custom field=value. Args: owner: The GitHub organization or user name project_number: The project number limit: Maximum number of items to return (default: 50). When filtering, the system automatically fetches more items to improve efficiency. state: Optional state filter (e.g., "OPEN", "CLOSED"). Applies to Issues/PRs. filter_field_name: Optional custom field name to filter by (e.g., "Status"). Currently supports SingleSelect and Iteration fields. filter_field_value: Optional custom field value to filter by (e.g., "In Development"). Uses case-insensitive matching. cursor: Optional cursor for pagination. Use value from previous results to get next page. Returns: A formatted string with item details.
Create a new GitHub issue. Args: owner: The GitHub organization or user name repo: The repository name title: The issue title body: The issue body (optional) Returns: A formatted string with the created issue details
Add an existing GitHub issue to a Project V2. Args: owner: The GitHub organization or user name that owns the project project_number: The project number issue_owner: The owner of the repository containing the issue issue_repo: The repository name containing the issue issue_number: The issue number Returns: A formatted string confirming the addition
Update a field value for a project item. Args: owner: The GitHub organization or user name project_number: The project number item_id: The ID of the item to update field_id: The ID of the field to update field_value: The new value for the field (text, date, or option ID for single select) Returns: A confirmation message
Create a draft issue directly in a GitHub Project V2. Args: owner: The GitHub organization or user name project_number: The project number title: The draft issue title body: The draft issue body (optional) Returns: A confirmation message with the new draft issue details
Delete an item from a GitHub Project V2. Args: owner: The GitHub organization or user name project_number: The project number item_id: The ID of the item to delete Returns: A confirmation message
概览
What is Github Projects Mcp Server?
It is a Model Context Protocol (MCP) server that provides tools for managing GitHub Projects V2 through Claude and other MCP clients. It uses the GitHub GraphQL API to interact with GitHub Projects V2.
How to use Github Projects Mcp Server?
Configure the server in your MCP client (e.g., Claude Desktop) using either the published package (uvx mcp-github-projects) or by running from source. Set a GitHub Personal Access Token with repo, project, and read:org scopes as the GITHUB_TOKEN environment variable. Example configuration via uvx is provided in the README.
Key features of Github Projects Mcp Server
- List GitHub Projects V2 for users or organizations
- Get project fields and items (issues, PRs, draft issues)
- Create GitHub issues and add them to projects
- Create draft issues directly in projects
- Update project item field values
- Delete items from projects
Use cases of Github Projects Mcp Server
- Manage project boards through natural language conversations with an AI
- Automate adding issues to projects as they are created
- Update project field values (e.g., status, priority) without a UI
- Quickly fetch project structure and item details
FAQ from Github Projects Mcp Server
What permissions are required for the GitHub token?
The token must have the repo, project, and read:org scopes.
Can I use this server with any MCP client?
Yes, the server works with any MCP client, such as Claude Desktop.
How do I install the server?
You can either run the published package directly using uvx mcp-github-projects or clone the repository and install from source with uv pip install -e ..
Where does project data live?
All data remains on GitHub’s servers; the server only queries and mutates it via the GraphQL API.
Does the server require a specific runtime?
Yes, it requires Python and the uv package manager (used for both packaged and source installations).
版本控制 分类下的更多 MCP 服务器
GitHub Actions 工作流使用说明
HenryHaosonYuque mcp server
Jira MCP
nguyenvanduocitA Go-based MCP (Model Control Protocol) connector for Jira that enables AI assistants like Claude to interact with Atlassian Jira. This tool provides a seamless interface for AI models to perform common Jira operations including issue management, sprint planning, and workflow tra
GitHub MCP Server Extension for Zed
LoamStudiosA GitHub MCP Server extension for Zed
Github Mcp Server
githubGitHub's official MCP Server
GitLab MCP Server
yoda-digitalProduction-grade GitLab MCP server with 86 tools — full GitLab control from any AI agent (Claude, Cursor, Zed).
评论