Github MCP Server Claude

🚀 GitHub MCP Server

The GitHub MCP Server is an API-based tool that uses the MCP (Modular Command Processor) framework to interact with GitHub, providing various functions for retrieving user and repository information.

🚀 Quick Start

The GitHub MCP Server is a tool developed in Python, leveraging the httpx library for asynchronous API calls and dotenv for secure handling of GitHub authentication tokens. It interacts with GitHub using the MCP framework, enabling users to access a variety of GitHub data.

✨ Features

• Retrieve GitHub user information by username.
• Obtain detailed information about repositories.
• Fetch authenticated user data using a GitHub personal access token.
• Utilize FastMCP for modular command processing.

📦 Installation

Prerequisites

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

Steps

1. Clone the repository

   git clone https://github.com/DivyanshKushwaha/GitHub-MCP-Server-Claude.git
   cd GitHub-MCP-Server-Claude
   

2. Create a Python virtual environment

python -m venv venv
source venv/bin/activate  

3. Install dependencies

pip install -r requirements.txt

4. Set up environment variables (create a .env file)

GITHUB_TOKEN=your_personal_access_token

5. Configure claude_desktop_config.json

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

• The command key specifies the location of the uv script used to run the server (in the conda environment).
• The args key provides additional parameters for the uv script:
  • "run": Indicates the "run" operation to start the server.
  • my_env: Specifies the Python environment my_env.
  • "D:/MCP_Project/main.py": Specifies the path to the main script containing the MCP server implementation.

6. Launch the Claude desktop application

• Open the Claude desktop application.
• It will use the MCP server configured in the claude_desktop_config.json file to fetch and process data.

📚 Documentation

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: Contains the core logic of the GitHub MCP Server.
• .env: Stores environment variables (e.g., GitHub Token).
• claude_desktop_config.json: Configuration file for the Claude desktop application.
• requirements.txt: Lists the required dependencies.
• explanation_video.mp4: A video explaining the project's functionality.