mcp-server

mcp-server

0
developer_toolsai_chatbot

This project is a Model Context Protocol server designed for GitHub repositories. It allows AI assistants to access repository data like files and commits and is built with a focus on secure access and deployment on platforms like Heroku.

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 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.