返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端