GitHub MCP 服务器

概述

GitHub MCP 服务器是一个基于 API 的工具，使用 MCP (模块化命令处理器) 框架与 GitHub 进行交互。它提供了多种功能，包括通过 GitHub 的 REST API 获取用户信息、仓库信息以及经过身份验证的用户数据。

该项目使用 Python 开发，并利用 httpx 库进行异步 API 调用。此外，它还使用 dotenv 来安全处理 GitHub 认证令牌。

功能

• 通过用户名获取 GitHub 用户信息。
• 获取仓库的详细信息。
• 使用 GitHub 个人访问令牌获取经过身份验证的用户数据。
• 利用 FastMCP 进行模块化命令处理。

项目结构

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：一个解释项目功能的视频。

安装与使用说明

先决条件

• 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 服务器来获取和处理数据。