Divyanshkushwaha GitHub MCP Server Claude

🚀 GitHub MCP Server

The GitHub MCP Server is an API - based tool that interacts with GitHub using the MCP (Modular Command Processor) framework. It offers a variety of functions, including retrieving user information, repository details, and authenticated user data via the GitHub REST API.

🚀 Quick Start

The GitHub MCP Server is a powerful tool designed to interact with GitHub. Here's a brief guide on how to get started.

✨ Features

• Retrieve GitHub user information by username.
• Obtain detailed information about repositories.
• Fetch authenticated user data using a GitHub personal access token.
• Leverage 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

Setup and Usage

1. Clone the repository

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

2. Create a Python environment

python -m venv venv
source venv/bin/activate

3. Install dependencies

pip install -r requirements.txt

4. Set 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 in the environment, which is used to run the server.
• The args key provides additional parameters for the uv script:
  • "run": Indicates the operation to execute the server.
  • my_env: The Python environment 'my_env'
  • "D:/MCP_Project/main.py": Specifies the path to the main.py 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 retrieve 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 running the MCP Server.
• requirements.txt: Lists the required dependencies.
• explanation_video.mp4: A video explaining the project's functionality.