GitHub MCP Server

by faheema15

Integration GitHub API AI Assistants FastAPI OpenAPI

This project demonstrates a Model Context Protocol (MCP) Server that integrates with the GitHub API. It allows AI Assistants like Claude or OpenAI GPT to interact with GitHub using MCP.

View on GitHub

Last updated: N/A

What is GitHub MCP Server?

This is an MCP Server that exposes a REST API allowing AI Assistants to interact with GitHub. It enables fetching user profiles, listing repositories, and creating issues.

How to use GitHub MCP Server?

To use this server, you need a GitHub Personal Access Token (PAT) set as an environment variable. You can then deploy the server on Railway or run it locally. AI assistants can interact with the server by registering the .well-known/ai-plugin.json URL and using natural language prompts.

Key features of GitHub MCP Server

MCP-compliant server with OpenAPI documentation
Secure interaction with GitHub using a personal access token
Fetch GitHub user details
List repositories by username
Create issues on repositories

Use cases of GitHub MCP Server

Allow AI assistants to manage GitHub repositories
Automate issue creation based on AI-driven analysis
Enable AI-powered code review workflows
Integrate GitHub data into AI-driven reporting dashboards

FAQ from GitHub MCP Server

What is a GitHub Personal Access Token (PAT)?

A PAT is a token that allows you to access GitHub resources without using your username and password. It's used for authentication.

How do I set up the GITHUB_TOKEN environment variable?

You can set it in your .env file for local development or directly in Railway's environment settings for deployment.

What permissions does the PAT need?

The PAT needs the repo permission to allow the server to access and modify repositories.

Where can I find the OpenAPI documentation?

Visit http://localhost:8000/docs when running the server locally to access the Swagger UI.