article
README
🚀 GitHub MCP 服务器
GitHub MCP 服务器是一款基于 API 的实用工具,借助 MCP (模块化命令处理器) 框架实现与 GitHub 的交互。它具备丰富功能,可获取用户信息、仓库信息以及认证用户数据,这些数据均通过 GitHub REST API 获得。
🚀 快速开始
先决条件
- Python >=3.10
- GitHub 个人访问令牌(用于认证请求)
conda或venv用于虚拟环境管理
设置与使用
- 克隆仓库
git clone https://github.com/DivyanshKushwaha/GitHub-MCP-Server-Claude.git
cd GitHub-MCP-Server-Claude
- 创建 Python 环境
python -m venv venv
source venv/bin/activate
- 安装依赖项
pip install -r requirements.txt
- 设置环境变量(创建 .env 文件)
GITHUB_TOKEN=your_personal_access_token
- 配置 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 脚本路径。
- 启动 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 认证令牌。
Scan to join WeChat group