Skip to main content
Glama
enesjakozh

PyGithub MCP Server

by AstroMined
GitHub
Python
MIT License
1
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

PyGithub MCP Server

A Model Context Protocol server that provides tools for interacting with the GitHub API through PyGithub. This server enables AI assistants to perform GitHub operations like managing issues, repositories, and pull requests.

Features

  • Modular Tool Architecture:

    • Configurable tool groups that can be enabled/disabled

    • Domain-specific organization (issues, repositories, etc.)

    • Flexible configuration via file or environment variables

    • Clear separation of concerns with modular design

    • Easy extension with consistent patterns

  • Complete GitHub Issue Management:

    • Create and update issues

    • Get issue details and list repository issues

    • Add, list, update, and delete comments

    • Manage issue labels

    • Handle assignees and milestones

  • Smart Parameter Handling:

    • Dynamic kwargs building for optional parameters

    • Proper type conversion for GitHub objects

    • Validation for all input parameters

    • Clear error messages for invalid inputs

  • Robust Implementation:

    • Object-oriented GitHub API interactions via PyGithub

    • Centralized GitHub client management

    • Proper error handling and rate limiting

    • Clean API abstraction through MCP tools

    • Comprehensive pagination support

    • Detailed logging for debugging

Documentation

Comprehensive guides are available in the docs/guides directory:

  • error-handling.md: Error types, handling patterns, and best practices

  • security.md: Authentication, access control, and content security

  • tool-reference.md: Detailed tool documentation with examples

See these guides for detailed information about using the PyGithub MCP Server.

Usage Examples

Issue Operations

  1. Creating an Issue

{ "owner": "username", "repo": "repository", "title": "Issue Title", "body": "Issue description", "assignees": ["username1", "username2"], "labels": ["bug", "help wanted"], "milestone": 1 }

  1. Getting Issue Details

{ "owner": "username", "repo": "repository", "issue_number": 1 }

  1. Updating an Issue

{ "owner": "username", "repo": "repository", "issue_number": 1, "title": "Updated Title", "body": "Updated description", "state": "closed", "labels": ["bug", "wontfix"] }

Comment Operations

  1. Adding a Comment

{ "owner": "username", "repo": "repository", "issue_number": 1, "body": "This is a comment" }

  1. Listing Comments

{ "owner": "username", "repo": "repository", "issue_number": 1, "per_page": 10 }

  1. Updating a Comment

{ "owner": "username", "repo": "repository", "issue_number": 1, "comment_id": 123456789, "body": "Updated comment text" }

Label Operations

  1. Adding Labels

{ "owner": "username", "repo": "repository", "issue_number": 1, "labels": ["enhancement", "help wanted"] }

  1. Removing a Label

{ "owner": "username", "repo": "repository", "issue_number": 1, "label": "enhancement" }

All operations handle optional parameters intelligently:

  • Only includes provided parameters in API calls

  • Converts primitive types to GitHub objects (e.g., milestone number to Milestone object)

  • Provides clear error messages for invalid parameters

  • Handles pagination automatically where applicable

Installation

  1. Create and activate a virtual environment:

uv venv source .venv/bin/activate

  1. Install dependencies:

uv pip install -e .

Configuration

Basic Configuration

Add the server to your MCP settings (e.g., claude_desktop_config.json or cline_mcp_settings.json):

{ "mcpServers": { "github": { "command": "/path/to/repo/.venv/bin/python", "args": ["-m", "pygithub_mcp_server"], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token-here" } } } }

Tool Group Configuration

The server supports selectively enabling or disabling tool groups through configuration. You can configure this in two ways:

1. Configuration File

Create a JSON configuration file (e.g., pygithub_mcp_config.json):

{ "tool_groups": { "issues": {"enabled": true}, "repositories": {"enabled": true}, "pull_requests": {"enabled": false}, "discussions": {"enabled": false}, "search": {"enabled": true} } }

Then specify this file in your environment:

export PYGITHUB_MCP_CONFIG=/path/to/pygithub_mcp_config.json

2. Environment Variables

Alternatively, use environment variables to configure tool groups:

export PYGITHUB_ENABLE_ISSUES=true export PYGITHUB_ENABLE_REPOSITORIES=true export PYGITHUB_ENABLE_PULL_REQUESTS=false

By default, only the issues tool group is enabled. See README.config.md for more detailed configuration options.

Development

Testing

The project includes a comprehensive test suite:

# Run all tests pytest # Run tests with coverage report pytest --cov # Run specific test file pytest tests/test_operations/test_issues.py # Run tests matching a pattern pytest -k "test_create_issue"

Note: Many tests are currently failing and under investigation. This is a known issue being actively worked on.

Testing with MCP Inspector

Test MCP tools during development using the MCP Inspector:

source .venv/bin/activate # Ensure venv is activated npx @modelcontextprotocol/inspector -e GITHUB_PERSONAL_ACCESS_TOKEN=your-token-here uv run pygithub-mcp-server

Use the MCP Inspector's Web UI to:

  • Experiment with available tools

  • Test with real GitHub repositories

  • Verify success and error cases

  • Document working payloads

Project Structure

tests/ ├── unit/ # Fast tests without external dependencies │ ├── config/ # Configuration tests │ ├── tools/ # Tool registration tests │ └── ... # Other unit tests └── integration/ # Tests with real GitHub API ├── issues/ # Issue tools tests └── ... # Other integration tests
src/ └── pygithub_mcp_server/ ├── __init__.py ├── __main__.py ├── server.py # Server factory (create_server) ├── version.py ├── config/ # Configuration system │ ├── __init__.py │ └── settings.py # Configuration management ├── tools/ # Modular tool system │ ├── __init__.py # Tool registration framework │ └── issues/ # Issue tools │ ├── __init__.py │ └── tools.py # Issue tool implementations ├── client/ # GitHub client functionality │ ├── __init__.py │ ├── client.py # Core GitHub client │ └── rate_limit.py # Rate limit handling ├── converters/ # Data transformation │ ├── __init__.py │ ├── parameters.py # Parameter formatting │ ├── responses.py # Response formatting │ ├── common/ # Common converters │ ├── issues/ # Issue-related converters │ ├── repositories/ # Repository converters │ └── users/ # User-related converters ├── errors/ # Error handling │ ├── __init__.py │ └── exceptions.py # Custom exceptions ├── operations/ # GitHub operations │ ├── __init__.py │ └── issues.py ├── schemas/ # Data models │ ├── __init__.py │ ├── base.py │ ├── issues.py │ └── ... └── utils/ # General utilities ├── __init__.py └── environment.py # Environment utilities

Troubleshooting

  1. Server fails to start:

    • Verify venv Python path in MCP settings

    • Ensure all requirements are installed in venv

    • Check GITHUB_PERSONAL_ACCESS_TOKEN is set and valid

  2. Build errors:

    • Use --no-build-isolation flag with uv build

    • Ensure Python 3.10+ is being used

    • Verify all dependencies are installed

  3. GitHub API errors:

    • Check token permissions and validity

    • Review pygithub_mcp_server.log for detailed error traces

    • Verify rate limits haven't been exceeded

Dependencies

  • Python 3.10+

  • MCP Python SDK

  • Pydantic

  • PyGithub

  • UV package manager

License

MIT

Deploy Server
A
security – no known vulnerabilities
-
license - not tested
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Enables AI assistants to interact with GitHub through the PyGithub library, providing tools for managing issues, repositories, pull requests, and other GitHub operations with intelligent parameter handling and error management.

  1. Features
    1. Documentation
      1. Usage Examples
        1. Issue Operations
        2. Comment Operations
        3. Label Operations
      2. Installation
        1. Configuration
          1. Basic Configuration
          2. Tool Group Configuration
        2. Development
          1. Testing
          2. Testing with MCP Inspector
          3. Project Structure
          4. Troubleshooting
        3. Dependencies
          1. License

            Related Resources

            Related MCP Servers

            • GitHub MCP Server

              asbloom-py
              -
              security
              -
              license
              -
              quality
              Enables interaction with GitHub through the GitHub API, supporting file operations, repository management, advanced search, and issue tracking with comprehensive error handling and automatic branch creation.
              Last updated -
              3,264
              1

            • GitHub Enterprise MCP Server

              piyushgIITian
              A
              security
              -
              license
              A
              quality
              Enables interaction with GitHub repositories through the GitHub API, allowing file operations, repository management, issue tracking, and code search through natural language commands.
              Last updated -
              33
              2
              2
              MIT License
              • Apple
              • Linux

            • GitHub MCP Tools

              Pranesh-2005
              -
              security
              -
              license
              -
              quality
              A set of tools allowing AI assistants to interact directly with GitHub, enabling automation of tasks like fetching user profiles, creating repositories, and managing pull requests.
              Last updated -

            • GitMCP

              anillahane
              -
              security
              -
              license
              -
              quality
              Transforms any GitHub repository into a documentation hub for AI assistants, enabling access to up-to-date documentation and code to eliminate hallucinations. Supports repository-specific and dynamic endpoints with smart search capabilities.
              Last updated -
              Apache 2.0

            View all related MCP servers

            Appeared in Searches

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/AstroMined/pygithub-mcp-server'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server