mcp-server
If you are the rightful owner of mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This project implements a Model Context Protocol (MCP) server using FastAPI for GitHub interactions.
🚀 GitHub MCP Server - FastAPI Implementation
🌟 Overview
This project implements a Model Context Protocol (MCP) server using FastAPI, enabling AI assistants like Claude to interact with GitHub. The server provides API endpoints to fetch user details, manage repositories, create issues, and automate GitHub workflows.
✨ Features
- ✅ Fetch GitHub user details and repositories
- ✅ Create and manage issues in repositories
- ✅ List all issues in a repository
- ✅ Star a repository
- ✅ AI-powered GitHub Issue Summarization (Optional)
- ✅ Secure API with GitHub OAuth Token
- ✅ Asynchronous FastAPI implementation
🛠️ Setup & Installation
1️⃣ Clone the Repository
git clone https://github.com/snehaapratap/mcp-server.git
cd mcp-server
2️⃣ Create & Activate a Virtual Environment
python3 -m venv venv
source venv/bin/activate
3️⃣ Install Dependencies
pip install -r requirements.txt
4️⃣ Set Up Environment Variables
Create a .env file in the root directory and add your GitHub Personal Access Token (PAT):
GITHUB_TOKEN=your_personal_access_token
5️⃣ Run the FastAPI Server
uvicorn server:app --reload
The server will start on http://127.0.0.1:8000.
🔥 API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | / | Health check for MCP server |
| GET | /github/user | Fetch GitHub user details |
| GET | /github/repos | Get all repositories of the authenticated user |
| POST | /github/create-issue | Create an issue in a repository |
| GET | /github/list-issues | List all issues in a repository |
| PUT | /github/star-repo | Star a repository |
| POST | /github/summarize-issues | AI-powered issue summarization (Optional) |
⚡ Usage Examples (cURL)
🔹 Get User Details
curl -X GET "http://127.0.0.1:8000/github/user"
🔹 Fetch Repositories
curl -X GET "http://127.0.0.1:8000/github/repos"
🔹 Create an Issue
curl -X POST "http://127.0.0.1:8000/github/create-issue?owner=your-username&repo=your-repo&title=New%20Issue&body=This%20is%20a%20test%20issue"
🔹 Star a Repository
curl -X PUT "http://127.0.0.1:8000/github/star-repo?owner=your-username&repo=your-repo"
🎥 Slides
🛡️ Error Handling
The API handles errors gracefully and returns meaningful messages:
{
"error": "Invalid GitHub Token",
"hint": "Ensure your token has the 'repo' scope."
}
🎯 Future Enhancements
- 🔹 Support for pull requests management
- 🔹 Implement WebSockets for real-time GitHub notifications
- 🔹 Deploy on AWS/GCP with CI/CD pipeline
💡 Contributing
Want to improve this project? Feel free to open a pull request or file an issue!
👨💻 Author
🔹 Sneha P Pratap
🔹 GitHub: @snehaapratap
🔹 LinkedIn: Sneha Prem Pratap
