GitHub MCP Server

Overview

GitHub MCP Server is an API-based tool that interacts with GitHub using the MCP (Modular Command Processor) framework. It provides various functionalities, including fetching user details, repository information, and authenticated user data using GitHub's REST API.

This project is built using Python and leverages httpx for asynchronous API calls. It also uses dotenv for secure handling of GitHub authentication tokens.

Features

Fetch GitHub user information by username.
Retrieve details of a GitHub repository.
Get authenticated user details using a GitHub personal access token.
Utilizes FastMCP for modular command processing.

Project Structure

D:/MCP_Project/ 
|----.env
│----.gitignore
│----claude_desktop_config.json  (Create this file in C:\Users\your_username\AppData\Roaming\Claude\)
│----main.py
│----pyproject.toml
│----README.md
│----requirements.txt

main.py: Core logic of the GitHub MCP Server.
.env: Stores environment variables (e.g., GitHub Token).
claude_desktop_config.json: Configuration for running the MCP Server.
requirements.txt: Lists required dependencies.
explanation_video.mp4: A video explaining the project.

Setup Instructions

Prerequisites

Python >=3.10
GitHub personal access token (for authenticated requests)
conda or venv for virtual environment management

Setup and Usage

Clone the Repository
git clone https://github.com/DivyanshKushwaha/GitHub-MCP-Server-Claude.git cd GitHub-MCP-Server-Claude
Create Python environment

python -m venv venv
source venv/bin/activate  

Install Dependencies

pip install -r requirements.txt

Set Up Environment Variables (Create .env file)

GITHUB_TOKEN=your_personal_access_token

Setup claude_desktop_config.json

{
    "mcpServers": {
        "MCP_Server": {
            "command": "my_env/Scripts/uv",
            "args": [
                "run",
                "D:/MCP_Project/main.py"
            ]
        }
    }
}

The command key specifies the path to the uv script located in the conda environment. This is used to run the server.
The args key provides additional arguments for the uv script:
- "run": Indicates the action to run the server.
- my_env : python environment 'my_env'
- "D:/MCP_Project/main.py": Specifies the path to the main.py script, which contains the implementation of the MCP server.

Launch the Claude Desktop Application

Open the Claude Desktop Application.
It will use the MCP Server as configured in the claude_desktop_config.json file to fetch and process data.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A modular command processor server that enables interaction with GitHub's REST API to fetch user details, repository information, and authenticated user data through natural language commands in Claude.

Related MCP Servers

GitHub MCP Server
Jehan26
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to interact with GitHub repositories, issues, and pull requests.
Last updated -
6
Python
GitHub MCP Server
ualUsham
A
security
F
license
A
quality
An MCP server that enables Claude and other compatible LLMs to interact with the GitHub API, supporting features like creating issues, retrieving repository information, listing issues, and searching repositories.
Last updated -
4
TypeScript
GitHub MCP Server
alsonwangkhem
A
security
F
license
A
quality
An MCP server that allows Claude and other MCP-compatible LLMs to interact with the GitHub API, supporting features like creating issues, getting repository information, listing issues, and searching repositories.
Last updated -
4
TypeScript
GitHub Notifications MCP Server
mcollina
-
security
A
license
-
quality
An MCP server that enables AI assistants like Claude to help users manage their GitHub notifications through natural language commands.
Last updated -
2
15
TypeScript
MIT License

View all related MCP servers

GitHub MCP Server