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

Clone the repository:

git clone https://github.com/timbuchinger/mcp-github.git
cd mcp-github

Install dependencies with uv:

pip install uv
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -r requirements.txt

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:

Go to GitHub Settings -> Developer settings -> Personal access tokens
Generate a new token with repo scope
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 .

This server cannot be installed

security - not tested

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.

Related Resources

Reddit Discussion about this server

Related MCP Servers

GitHub MCP Server
asbloom-py
-
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
Github-Oauth MCP Server
Nikhil-Patil-RI
-
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
Github MCP Server
ParasSolanki
-
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
GitHub MCP Server
oghenetejiriorukpegmail
-
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

GitHub MCP Server