GitHub MCP Server

MCP-Inspector-v0.6.0

GitHub MCP Server

A Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with GitHub repositories, issues, and pull requests.

Features

Repository Search: Find GitHub repositories based on search queries
Issue Management: Get, create, and comment on issues
Pull Request Handling: View and manage pull requests
Repository Analysis: Get statistics and insights about repositories

Installation

Prerequisites

Python 3.8+
GitHub API token

Steps

Clone this repository:
git clone https://github.com/yourusername/github-mcp-server.git cd github-mcp-server
Install dependencies:
pip install -r requirements.txt
Set up your GitHub token as an environment variable:
export GITHUB_TOKEN=your_github_token_here
Run the server:
python server.py

The server will start running on http://localhost:5000.

Usage

Endpoints

The MCP server provides the following endpoints:

GET /mcp/discover: Returns available operations and their parameters
POST /mcp/execute: Executes operations based on provided parameters

Example Requests

Discovery

curl -X GET http://localhost:5000/mcp/discover

Execute Repository Search

curl -X POST http://localhost:5000/mcp/execute \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "search_repositories",
    "parameters": {
      "query": "machine learning"
    }
  }'

Get Repository Issues

curl -X POST http://localhost:5000/mcp/execute \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "get_repo_issues",
    "parameters": {
      "owner": "openai",
      "repo": "whisper"
    }
  }'

Architecture

The server follows the Model Context Protocol specification to allow AI assistants to:

Discover available operations
Execute operations with appropriate parameters
Process and return results in a structured format

Extending the Server

You can extend this server by:

Adding new endpoints in the discover() function
Implementing corresponding handler functions
Updating the routing in the execute() function

Security Considerations

The server uses an API token for authentication with GitHub
Implement rate limiting to prevent abuse
Add input validation for all parameters
Consider implementing OAuth for more secure token management

Demo

See the demo video for a walkthrough of the server's capabilities.

License

MIT License

Contact

For questions or support, please open an issue on this repository.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A Model Context Protocol server that enables AI assistants like Claude to interact with GitHub repositories, issues, and pull requests.

GitHub MCP Server

Related MCP Servers

@kazuph/mcp-github-pera1
kazuph
A
security
A
license
A
quality
A Model Context Protocol server that connects GitHub code to Claude.ai. This server utilizes the Pera1 service to extract code from GitHub repositories and provide better context to Claude.
Last updated -
1
31
1
JavaScript
MIT License
MCP GitHub Repository Server
loglmhq
-
security
A
license
-
quality
A server that allows AI assistants to browse and read files from specified GitHub repositories, providing access to repository contents via the Model Context Protocol.
Last updated -
3
JavaScript
MIT License
Codebase MCP
DeDeveloper23
-
security
A
license
-
quality
A Model Context Protocol server that enables AI agents to retrieve and understand entire codebases at once, providing tools to analyze local workspaces or remote GitHub repositories.
Last updated -
9
TypeScript
MIT License
GitHub MCP Server
PoliTwit1984
A
security
F
license
A
quality
A 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 -
1
JavaScript

View all related MCP servers

GitHub MCP Server

MCP-Inspector-v0.6.0