Github MCP Server Claude

🚀 GitHub MCP 服務器

GitHub MCP 服務器是一款基於 API 的實用工具，藉助 MCP (模塊化命令處理器) 框架與 GitHub 展開交互。它具備豐富功能，可通過 GitHub 的 REST API 獲取用戶信息、倉庫詳情以及經過身份驗證的用戶數據，為開發者提供了便捷的 GitHub 數據交互途徑。

🚀 快速開始

先決條件

• Python >=3.10
• GitHub 個人訪問令牌（用於經過身份驗證的請求）
• conda 或 venv 用於虛擬環境管理

安裝和配置

1. 克隆倉庫

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

2. 創建 Python 環境

python -m venv venv
source venv/bin/activate  

3. 安裝依賴項

pip install -r requirements.txt

4. 設置環境變量（創建 .env 文件）

GITHUB_TOKEN=your_personal_access_token

5. 配置 claude_desktop_config.json

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

• command 鍵指定用於運行服務器的 uv 腳本的位置（位於conda環境中）。
• args 鍵提供 uv 腳本的額外參數：
  • "run"：表示執行“運行”操作以啟動服務器。
  • my_env：指定 Python 環境 my_env。
  • "D:/MCP_Project/main.py"：指定包含 MCP 服務器實現的主腳本路徑。

6. 啟動 Claude 桌面應用程序

• 打開 Claude 桌面應用程序。
• 它將使用 claude_desktop_config.json 文件中配置的 MCP 服務器來獲取和處理數據。

✨ 主要特性

• 通過用戶名獲取 GitHub 用戶信息。
• 獲取倉庫的詳細信息。
• 使用 GitHub 個人訪問令牌獲取經過身份驗證的用戶數據。
• 利用 FastMCP 進行模塊化命令處理。

📦 安裝指南

先決條件

• Python >=3.10
• GitHub 個人訪問令牌（用於經過身份驗證的請求）
• conda 或 venv 用於虛擬環境管理

安裝步驟

1. 克隆倉庫

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

2. 創建 Python 環境

python -m venv venv
source venv/bin/activate  

3. 安裝依賴項

pip install -r requirements.txt

4. 設置環境變量（創建 .env 文件）

GITHUB_TOKEN=your_personal_access_token

5. 配置 claude_desktop_config.json

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

• command 鍵指定用於運行服務器的 uv 腳本的位置（位於conda環境中）。
• args 鍵提供 uv 腳本的額外參數：
  • "run"：表示執行“運行”操作以啟動服務器。
  • my_env：指定 Python 環境 my_env。
  • "D:/MCP_Project/main.py"：指定包含 MCP 服務器實現的主腳本路徑。

📚 詳細文檔

項目結構

D:/MCP_Project/ 
|----.env
│----.gitignore
│----claude_desktop_config.json  （在 C:\Users\your_username\AppData\Roaming\Claude\ 中創建此文件）
│----main.py
│----pyproject.toml
│----README.md
│----requirements.txt

• main.py：GitHub MCP 服務器的核心邏輯。
• .env：存儲環境變量（例如 GitHub Token）。
• claude_desktop_config.json：用於 Claude 桌面應用的配置文件。
• requirements.txt：列出所需的依賴項。
• explanation_video.mp4：一個解釋項目功能的視頻。

各文件作用說明

• main.py：GitHub MCP 服務器的核心邏輯所在，實現了與 GitHub 的交互功能。
• .env：用於存儲環境變量，如 GitHub Token，保障敏感信息的安全。
• claude_desktop_config.json：為 Claude 桌面應用提供配置信息，使其能正確使用 MCP 服務器。
• requirements.txt：列出了項目運行所需的依賴項，方便安裝和管理。
• explanation_video.mp4：通過視頻形式解釋項目的功能，幫助用戶更好地理解和使用。