GitHub API交互工具

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

  • by DivyanshKushwaha
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 divyanshkushwaha/github-mcp-server-claude

使用说明

GitHub MCP服务器

概述

GitHub MCP Server是一个基于API的工具,使用 MCP(模块化命令处理器) 框架。它提供了各种功能,包括使用GitHub的REST API获取用户详细信息、存储库信息和经过验证的用户数据。

该项目使用Python构建,并利用 httpx 用于异步API调用。它还使用 dotenv 用于安全处理GitHub身份验证令牌。

特性

  • 按用户名获取GitHub用户信息。
  • 检索GitHub存储库的详细信息。
  • 使用GitHub个人访问令牌获取经过身份验证的用户详细信息。
  • 利用 FastMCP 用于模块化命令处理。

项目结构

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.pyGitHub MCP服务器的核心逻辑。
  • .env:存储环境变量(例如GitHub Token)。
  • claude_desktop_config.json:用于运行MCP服务器的配置。
  • 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  
  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"
            ]
        }
    }
}
  • 命令键指定位于conda环境中的uv脚本的路径。这用于运行服务器。

  • args键为uv脚本提供了额外的参数:

    • “run”:表示运行服务器的操作。
    • my_env:python环境“my_env”
    • “D:/MCP_Project/main.py”:指定main.py脚本的路径,该脚本包含MCP服务器的实现。
  1. 启动Claude桌面应用程序
  • 打开克劳德桌面应用程序。
  • 它将使用claude_desktop_config.json文件中配置的MCP服务器来获取和处理数据。