Back to MCP directory
publicPublicdnsLocal runtime

DivyanshKushwaha_GitHub-MCP-Server-Claude

GitHub MCP Server是一个基于Python的API工具,通过MCP框架与GitHub REST API交互,提供用户信息、仓库数据和认证用户详情查询功能。

article

README

🚀 GitHub MCP 服务器

GitHub MCP 服务器是一款基于 API 的实用工具,借助 MCP (模块化命令处理器) 框架实现与 GitHub 的交互。它具备丰富功能,可获取用户信息、仓库信息以及认证用户数据,这些数据均通过 GitHub REST API 获得。

🚀 快速开始

先决条件

  • Python >=3.10
  • GitHub 个人访问令牌(用于认证请求)
  • condavenv 用于虚拟环境管理

设置与使用

  1. 克隆仓库
git clone https://github.com/DivyanshKushwaha/GitHub-MCP-Server-Claude.git
cd GitHub-MCP-Server-Claude
  1. 创建 Python 环境
python -m venv venv
source venv/bin/activate  
  1. 安装依赖项
pip install -r requirements.txt
  1. 设置环境变量(创建 .env 文件)
GITHUB_TOKEN=your_personal_access_token
  1. 配置 claude_desktop_config.json
{
    "mcpServers": {
        "MCP_Server": {
            "command": "my_env/Scripts/uv",
            "args": [
                "run",
                "D:/MCP_Project/main.py"
            ]
        }
    }
}
  • 命令键指定环境中 uv 脚本的位置,用于运行服务器。
  • args 键提供 uv 脚本的额外参数:
    • "run":表示执行服务器的操作。
    • my_env :Python 环境 'my_env'
    • "D:/MCP_Project/main.py":指定包含 MCP 服务器实现的 main.py 脚本路径。
  1. 启动 Claude 桌面应用程序
  • 打开 Claude 桌面应用程序。
  • 它将使用 claude_desktop_config.json 文件中配置的 MCP 服务器来获取和处理数据。

✨ 主要特性

  • 按用户名获取 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 令牌)。
  • claude_desktop_config.json:用于运行 MCP 服务器的配置文件。
  • requirements.txt:列出所需的依赖项。
  • explanation_video.mp4:一个解释项目功能的视频。

技术实现

该项目使用 Python 构建,并利用 httpx 库进行异步 API 调用。同时,它使用 dotenv 来安全地处理 GitHub 认证令牌。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client