GitHub Project Manager MCP Server

@marioalvial

代码仓库

基本信息

分类

版本控制

传输方式

stdio

作者

marioalvial

关于 GitHub Project Manager MCP Server

MCP server wrapping the GitHub CLI (gh) to provide tools for managing GitHub resources

GitHub Project Manager MCP Server 配置

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

{
  "mcpServers": {
    "gh-project-manager": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GH_TOKEN",
        "ghcr.io/marioalvial/gh-project-manager-mcp"
      ],
      "env": {
        "GH_TOKEN": ""
      }
    }
  }
}

GitHub Project Manager MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is GitHub Project Manager MCP?

A model context protocol (MCP) server that manages GitHub projects via the GitHub CLI (gh). It handles common operations like issues and pull requests, with planned support for GitHub Projects. It is intended for developers using AI assistants that support MCP.

How to use GitHub Project Manager MCP?

Run the server as a Docker container with your GitHub token set as an environment variable. The image is published as ghcr.io/marioalvial/gh-project-manager-mcp. Example command: docker run -i --rm -e GH_TOKEN=your_token ghcr.io/marioalvial/gh-project-manager-mcp. Configuration for the Cursor editor is provided in the README.

Key features of GitHub Project Manager MCP

Issue creation, retrieval, and management
Pull request creation, retrieval, and management
Future integration with GitHub Projects
Docker‑based deployment with no local installation
Integration test suite for direct GitHub API interaction

Use cases of GitHub Project Manager MCP

Automate issue triage via an AI assistant
Create or review pull requests through conversational commands
Manage a repository’s workflow without leaving the chat interface

常见问题

How do I configure the server in Cursor?

Add the provided JSON configuration to your `.cursor/mcp.json`. It runs the Docker container with the `GH_TOKEN` environment variable set to your GitHub token.

What tools does the server currently offer?

The server provides tools for managing GitHub issues and pull requests. Support for GitHub Projects is planned for the future.

What permissions are required for the GitHub token?

The token needs at least the `repo` and `project` scopes to interact with repositories and projects.

How can I run the integration tests?

Set the environment variables `GH_INTEGRATION_TEST_TOKEN`, `GH_INTEGRATION_TEST_OWNER`, `GH_INTEGRATION_TEST_REPO`, and optionally `GH_INTEGRATION_TEST_PROJECT_ID`, then run `make function-integration-test`. Tests create real resources on GitHub.