GitHub MCP Server

by timbuchinger

Integrations

  • Allows to list and create GitHub issues from a repository

GitHub MCP Server

A Model Context Protocol (MCP) server implementation for interacting with GitHub issues through Cline.

Features

  • List GitHub issues from a repository
  • Create new GitHub issues
  • Error handling and validation
  • Secure authentication via environment variables

Installation

  1. Clone the repository:
git clone https://github.com/timbuchinger/mcp-github.git cd mcp-github
  1. Install dependencies with uv:
pip install uv uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv pip install -r requirements.txt
  1. Copy the environment template and configure your GitHub token:
cp .env.template .env

Edit .env and add your GitHub Personal Access Token:

GITHUB_TOKEN=your_token_here

To create a GitHub Personal Access Token:

  1. Go to GitHub Settings -> Developer settings -> Personal access tokens
  2. Generate a new token with repo scope
  3. Copy the token and paste it in your .env file

Usage

Run the MCP server:

python -m src.mcp_github.server

The server will start and expose two tools to Cline:

get_issues

Get a list of issues from a GitHub repository:

{ "repo": "owner/repo" }

create_issue

Create a new issue in a GitHub repository:

{ "repo": "owner/repo", "title": "Issue title", "body": "Issue description" }

Error Handling

The server handles common errors:

  • Missing GitHub token
  • Invalid repository name
  • Missing required parameters
  • GitHub API errors

Error responses include descriptive messages to help troubleshoot issues.

Development

The project uses uv for dependency management. To set up a development environment:

# Install all dependencies (including dev dependencies) uv pip install -r requirements.txt # Run tests pytest # Format code black . # Type checking mypy .
-
security - not tested
F
license - not found
-
quality - not tested

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.

Enables interaction with GitHub issues via the Model Context Protocol, allowing users to list and create issues with secure authentication.

  1. Features
    1. Installation
      1. Usage
        1. get_issues
        2. create_issue
      2. Error Handling
        1. Development

          Related MCP Servers

          • -
            security
            F
            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 -
            9
            1
            TypeScript
          • -
            security
            F
            license
            -
            quality
            Facilitates authentication with GitHub using OAuth protocol, allowing secure access and interaction with GitHub repositories and services.
            Last updated -
            2
            Python
            • Apple
            • Linux
          • -
            security
            F
            license
            -
            quality
            Provides integration with Github through the Model Context Protocol (MCP), allowing Large Language Models to interact with Github's repositories, issues, pull requests and search functionality.
            Last updated -
            1
            TypeScript
            • Apple
          • -
            security
            F
            license
            -
            quality
            Provides tools for interacting with GitHub's API through the MCP protocol, allowing users to create repositories, push content, and retrieve user information.
            Last updated -
            JavaScript

          View all related MCP servers

          ID: j37nzp7f8j