GitHub MCP Server

MCP Server for the GitHub API, enabling file operations, repository management, search functionality, and more.

Features

• Automatic Branch Creation: When creating/updating files or pushing changes, branches are automatically created if they don't exist
• Comprehensive Error Handling: Clear error messages for common issues
• Git History Preservation: Operations maintain proper Git history without force pushing
• Batch Operations: Support for both single-file and multi-file operations
• Advanced Search: Support for searching code, issues/PRs, and users

Tools

1. `create_or_update_file`

2. `push_files`

3. `search_repositories`

4. `create_repository`

5. `get_file_contents`

6. `create_issue`

7. `create_pull_request`

8. `fork_repository`

9. `create_branch`

10. `list_issues`

11. `update_issue`

12. `add_issue_comment`

13. `search_code`

14. `search_issues`

15. `search_users`

16. `list_commits`

17. `get_issue`

18. `get_pull_request`

19. `list_pull_requests`

20. `create_pull_request_review`

21. `merge_pull_request`

22. `get_pull_request_files`

23. `get_pull_request_status`

24. `update_pull_request_branch`

25. `get_pull_request_comments`

26. `get_pull_request_reviews`

Search Query Syntax

Code Search

• `language:javascript`: Search by programming language
• `repo:owner/name`: Search in specific repository
• `path:app/src`: Search in specific path
• `extension:js`: Search by file extension
• Example: `q: "import express" language:typescript path:src/`

Issues Search

• `is:issue` or `is:pr`: Filter by type
• `is:open` or `is:closed`: Filter by state
• `label:bug`: Search by label
• `author:username`: Search by author
• Example: `q: "memory leak" is:issue is:open label:bug`

Users Search

• `type:user` or `type:org`: Filter by account type
• `followers:>1000`: Filter by followers
• `location:London`: Search by location
• Example: `q: "fullstack developer" location:London followers:>100`

For detailed search syntax, see GitHub's searching documentation.

Setup

Personal Access Token

Create a GitHub Personal Access Token with appropriate permissions:

Usage with Claude Desktop

To use this with Claude Desktop, add the following to your `claude_desktop_config.json`:

Docker

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "mcp/github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": ""
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": ""
      }
    }
  }
}

Build

Docker build:

docker build -t mcp/github -f src/github/Dockerfile .

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.