mcp-server

🚀 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

---

⚡ 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

📌 View the 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

---