Github Projects MCP Server

@Arclio

代码仓库

基本信息

分类

版本控制

传输方式

stdio

作者

Arclio

提交者

Hillary

关于 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.

#github-mcp#github-projects#mcp-server

Github Projects MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "github-projects": {
      "command": "uvx",
      "args": [
        "mcp-github-projects"
      ],
      "env": {
        "GITHUB_TOKEN": "TOKEN"
      }
    }
  }
}

Github Projects MCP Server 工具

List 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

常见问题

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 服务器

Jira MCP

nguyenvanduocit

A 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

Atlassian Bitbucket MCP Server

aashari

Node.js/TypeScript MCP server for Atlassian Bitbucket. Enables AI systems (LLMs) to interact with workspaces, repositories, and pull requests via tools (list, get, comment, search). Connects AI directly to version control workflows through the standard MCP interface.

157