MCP: GitHub MCP Server

This project exposes GitHub repository actions (like listing PRs, issues, creating issues, and merging PRs) as OpenAPI endpoints using FastAPI.
It is designed to be deployed as a Managed Control Plane (MCP) server for use with an LLM agent orchestration framework.

Features

• List open pull requests for a repo
• List open issues
• Create new issues
• Merge pull requests

Tech Stack

• Python 3.12
• FastAPI
• Docker
• Google Cloud Run
• GitHub REST API

Project Structure

MCP/
 ├── server.py
 ├── requirements.txt
 ├── Dockerfile
 ├── .gitignore
 ├── .env (NOT committed, use Cloud Run env vars)

Setup & Run Locally

1. Clone the repo:

   git clone https://github.com/ShyaM-SqS/MCP.git
   cd MCP
   

2. Create a virtual environment:

   python -m venv .venv
   

3. Activate your environment:

   # Windows PowerShell
   .venv\Scripts\Activate
   
   # Or on Mac/Linux
   source .venv/bin/activate
   

4. Install dependencies:

   pip install -r requirements.txt
   

5. Create a .env file with your GitHub token:

   GITHUB_TOKEN=<your_personal_access_token>
   

6. Run the server locally:

   uvicorn server:app --reload --host 0.0.0.0 --port 8080
   

Deployment

• Build and push your container image to Artifact Registry, Docker Hub, or Cloud Build.
• Deploy to Google Cloud Run.
• Pass GITHUB_TOKEN securely as an environment variable in your Cloud Run service configuration.

License

Apache 2.0