🚀 GitHub MCP Server - FastAPI Implementation

🚀 GitHub MCP Server - FastAPI Implementation

site icon
2025.03.15 1
PythonGitHub集成自动化工具AI助手接口开发效率交流协作
GitHub MCP Server是一个基于FastAPI实现的模型上下文协议(MCP)服务器,旨在使AI助手(如Claude)能够与GitHub进行交互。该服务器提供了一系列API端点,用于获取用户详细信息、管理仓库、创建问题以及自动化GitHub工作流程。
View on GitHub

Overview

🌟 基本能力

产品定位

GitHub MCP Server是一个桥梁服务,连接AI助手与GitHub平台,提供自动化操作和交互能力。

核心功能

  • 获取GitHub用户详情和仓库列表
  • 创建和管理仓库中的问题(issues)
  • 列出仓库中的所有问题
  • 为仓库加星标(star)
  • AI驱动的问题摘要功能(可选)
  • 使用GitHub OAuth Token进行安全API访问
  • 异步FastAPI实现

适用场景

  • AI助手需要与GitHub交互的场景
  • 自动化GitHub工作流程
  • 批量管理仓库问题
  • 集成GitHub功能到其他应用中

🛠️ 使用教程

使用依赖

  1. Python 3环境
  2. Git

安装教程

  1. 克隆仓库
git clone https://github.com/snehaapratap/mcp-server.git
cd mcp-server
  1. 创建并激活虚拟环境
python3 -m venv venv
source venv/bin/activate
  1. 安装依赖
pip install -r requirements.txt
  1. 设置环境变量 创建.env文件并添加GitHub个人访问令牌
GITHUB_TOKEN=your_personal_access_token
  1. 运行服务器
uvicorn server:app --reload

调试方式

  1. 健康检查
curl -X GET "http://127.0.0.1:8000/"
  1. 获取用户详情
curl -X GET "http://127.0.0.1:8000/github/user"
  1. 获取仓库列表
curl -X GET "http://127.0.0.1:8000/github/repos"
  1. 创建问题
curl -X POST "http://127.0.0.1:8000/github/create-issue?owner=your-username&repo=your-repo&title=New%20Issue&body=This%20is%20a%20test%20issue"

许可证

None