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

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

@kazuph/mcp-github-pera1
kazuph
A
security
A
license
A
quality
A Model Context Protocol server that connects GitHub code to Claude.ai. This server utilizes the Pera1 service to extract code from GitHub repositories and provide better context to Claude.
Last updated -
1
31
1
JavaScript
MIT License
MCP GitHub Repository Server
loglmhq
-
security
A
license
-
quality
A server that allows AI assistants to browse and read files from specified GitHub repositories, providing access to repository contents via the Model Context Protocol.
Last updated -
3
JavaScript
MIT License
GitHub MCP Server
PoliTwit1984
A
security
F
license
A
quality
A Model Context Protocol server that enables AI models to interact with GitHub's API, allowing for repository creation and management with descriptions, topics, and website URLs through natural language commands.
Last updated -
1
JavaScript
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 -
129
Python

View all related MCP servers

GitHub MCP Server