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

github-mcp-server-c3g

一个基于FastAPI的GitHub模型上下文协议服务器,提供仓库详情获取、问题管理等功能。

article

README

🚀 GitHub MCP 服务器

本项目是一个借助 FastAPI 实现的 Model Context Protocol(MCP),用于与 GitHub 进行交互的快速 API 服务器,能高效处理各类 GitHub 相关操作。

🚀 快速开始

安装指南

  1. 克隆仓库。
  2. 创建虚拟环境:
    python -m venv venv
    source venv/bin/activate 
    
  3. 安装依赖项:
    pip install -r requirements.txt
    
  4. 创建包含您 GitHub 个人访问令牌的 .env 文件:
    GITHUB_TOKEN=your_token_here
    

使用示例

基础用法

启动服务器:

uvicorn server:app --reload --port 8000

📚 详细文档

API 接口

获取仓库详细信息

GET /repository/{owner}/{repo}

列出问题

GET /repository/{owner}/{repo}/issues

创建问题

POST /repository/{owner}/{repo}/issues

创建评论

POST /repository/{owner}/{repo}/issues/{issue_number}/comments

错误处理

该服务器实现了所有 GitHub API 交互的全面错误处理。错误会被记录,并返回适当的 HTTP 状态码。

类型提示

代码库在整个过程中都使用了类型提示,以提高维护性和 IDE 支持。

help

运行方式说明

cloud

托管运行

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

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

本地运行 / 其它方式

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

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