GitHub Interaction Module for Claude Environment

Introduction

This module serves as an API client for GitHub, engineered to operate within the MCP (Modular Command Processor) architecture. It leverages GitHub's public and secured REST endpoints to pull essential system data, such as occupant profiles, project metadata, and token-verified user status.

The implementation stack relies on Python, employing the asynchronous networking library httpx, and utilizes dotenv for safeguarding sensitive access credentials.

Core Capabilities

• Query GitHub user entities based on their unique identifier (username).
• Extract comprehensive details pertaining to a specified GitHub repository.
• Obtain information for the currently authorized principal using a Personal Access Token (PAT).
• Command processing is managed via the integrated FastMCP structure.

System Layout

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

• main.py: Houses the primary operational logic for this GitHub service.
• .env: Dedicated storage location for environment secrets (e.g., GITHUB_TOKEN).
• claude_desktop_config.json: Configuration file dictating how the MCP Server initiates.
• requirements.txt: Manifest listing all necessary Python package prerequisites.
• explanation_video.mp4: Instructional media demonstrating project deployment and use.

Deployment Guide

Prerequisites

• Python interpreter, version 3.10 or newer.
• A valid GitHub Personal Access Token (required for privileged access).
• Virtual environment manager, such as conda or venv.

Installation and Execution

1. Repository Acquisition bash git clone https://github.com/DivyanshKushwaha/GitHub-MCP-Server-Claude.git cd GitHub-MCP-Server-Claude
2. Establish Python Sandbox

python -m venv venv
source venv/bin/activate  

1. Dependency Installation

pip install -r requirements.txt

1. Credential Configuration (Create .env)

GITHUB_TOKEN=paste_your_personal_access_token_here

1. Define Claude Configuration (claude_desktop_config.json)

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

• The command parameter points to the executable wrapper (uv script) residing within the specified Conda environment, used for launching the server process.

• The args array supplies parameters to the execution wrapper:

  • "run": Instructs the utility to execute the specified script.
  • my_env : Identifies the target Python environment named 'my_env'.
  • "D:/MCP_Project/main.py": Specifies the absolute path to the primary server implementation file.

• Initiate Claude Desktop Client

• Launch the Claude Desktop Application.
• The application will utilize the service endpoint configured in claude_desktop_config.json to interface with and process data from the GitHub MCP Server.