-
securityF
license-
qualityEnables management of development projects with GitHub integration, facilitating project tracking, repository linking, and metadata maintenance within the Model Context Protocol.
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
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
reposcopeCopy the token and paste it in your
.envfile
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
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
Related MCP Servers
- AsecurityFlicenseAqualityA Model Context Protocol server that enables AI models to interact with GitHub's API, allowing for repository creation and management with descriptions, topics, and website URLs through natural language commands.Last updated -
- -securityFlicense-qualityProvides 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 -3,2642
- -securityFlicense-qualityA Model Context Protocol server that supports remote connections and authenticates users via GitHub OAuth, allowing them to access tools based on their GitHub identity.Last updated -