mcpField
G
GitHub MCP Server

GitHub MCP Server

Local
github.com/FixingPixelsVersion Control0Updated 86w ago
Repository

About GitHub MCP Server

GitHub MCP Server is a Python SDK-based MCP server for providing AI assistants with GitHub repository context. It exposes files, commit history, issues, and pull requests, with authentication, access control, rate limiting, and caching.

Key features

  1. 01Access repository files and content
  2. 02Retrieve commit history
  3. 03Access issues and pull requests
  4. 04Authentication and access control
  5. 05GitHub API rate limiting and caching

Use cases

  1. 01Inspect repository files through an AI assistant
  2. 02Review commit history
  3. 03Retrieve issues and pull requests
  4. 04Control and limit GitHub API access

MCP support

The server implements MCP for GitHub repositories, exposing repository files, commits, issues, and pull requests to MCP-enabled AI assistants.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

GitHub MCP Server

A Model Context Protocol (MCP) server for GitHub repositories, built using the Python SDK.

Overview

This server implements the Model Context Protocol (MCP) for GitHub repositories, allowing AI assistants to access repository context such as files, commits, issues, and pull requests. It's built using the MCP Python SDK and designed to be deployed on Heroku.

Features

  • Access GitHub repository files and content
  • Retrieve commit history
  • Access issues and pull requests
  • Secure authentication and access control
  • Rate limiting and caching for GitHub API
  • Compatible with MCP-enabled AI assistants

Requirements

  • Python 3.8+
  • GitHub API access
  • Heroku account (for deployment)

Installation

  1. Clone the repository:

    git clone https://github.com/FixingPixels/mcp-server.git
cd mcp-server

  2. Create a virtual environment:

    python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

  3. Install dependencies:

    pip install -r requirements.txt

  4. Set up environment variables:

    cp .env.example .env
# Edit .env with your GitHub API token and other settings

Usage

Local Development
uvicorn src.mcp_server.main:app --reload
Deployment

This server is designed to be deployed on Heroku. See the deployment documentation for details.

Documentation

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.