Github MCP Server C3g

🚀 GitHub MCP Server

A fast API server using FastAPI to implement the Model Context Protocol (MCP) for GitHub interaction.

🚀 Quick Start

This is a fast API server that uses FastAPI to implement the Model Context Protocol (MCP) for GitHub interaction.

📦 Installation

1. Clone the repository.
2. Create a virtual environment:

   python -m venv venv
   source venv/bin/activate 
   

3. Install the dependencies:

   pip install -r requirements.txt
   

4. Create a .env file containing your GitHub personal access token:

   GITHUB_TOKEN=your_token_here
   

💻 Usage Examples

Basic Usage

Start the server:

uvicorn server:app --reload --port 8000

📚 Documentation

API Endpoints

Get Repository Details

GET /repository/{owner}/{repo}

List Issues

GET /repository/{owner}/{repo}/issues

Create an Issue

POST /repository/{owner}/{repo}/issues

Create a Comment

POST /repository/{owner}/{repo}/issues/{issue_number}/comments

🔧 Technical Details

Error Handling

The server implements comprehensive error handling for all GitHub API interactions. Errors are logged, and appropriate HTTP status codes are returned.

Type Hints

The codebase uses type hints throughout to improve maintainability and IDE support.