GitHub Project Manager MCP logo

GitHub Project Manager MCP

by marioalvial

This project implements an MCP server specialized in GitHub project management operations. It offers integration with the GitHub CLI (`gh`) for common tasks like issue and pull request management.

View on GitHub

Last updated: N/A

What is GitHub Project Manager MCP?

A Model Context Protocol (MCP) server for managing projects on GitHub, integrating with the GitHub CLI (gh) to automate common tasks.

How to use GitHub Project Manager MCP?

The server can be used with Docker, as shown in the provided Docker run command, requiring a GitHub token. For integration with Cursor, the provided JSON configuration should be added to the .cursor/mcp.json file, replacing seu_token_github with your actual GitHub token.

Key features of GitHub Project Manager MCP

  • Issue Management

  • Pull Request Management

  • Integration with GitHub CLI

  • Dockerized Deployment

  • Semantic Versioning

  • Integration Tests

Use cases of GitHub Project Manager MCP

  • Automating GitHub project tasks

  • Integrating GitHub project management into development workflows

  • Managing issues and pull requests via Cursor

  • Running integration tests to verify functionality

  • Creating pull requests using MCP tools

FAQ from GitHub Project Manager MCP

What is an MCP?

MCP stands for Model Context Protocol. It's a protocol for integrating tools and services.

How do I get a GitHub token?

You can create a personal access token on GitHub with the necessary permissions (repo, project).

What permissions are needed for the GitHub token?

At a minimum, the token needs repo and project scopes for the integration tests.

How do I run the integration tests?

Create a .env file with the required environment variables (GH_INTEGRATION_TEST_TOKEN, GH_INTEGRATION_TEST_OWNER, GH_INTEGRATION_TEST_REPO, GH_INTEGRATION_TEST_PROJECT_ID) and run make function-integration-test.

Why are integration tests important?

Integration tests ensure that the tool correctly interacts with the GitHub API and that resource creation and cleanup work as expected.