GitHub只读API服务

一个提供GitHub REST API只读访问的MCP服务器,支持通过标准化接口与GitHub仓库、用户、问题、拉取请求等进行交互。

  • by nsingla
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 nsingla/mcp-github-readonly

使用说明

MCP GitHub只读服务器

模型上下文协议(MCP)服务器,提供对GitHub REST API的只读访问。此服务器允许您通过标准化的界面与GitHub存储库、用户、问题、拉取请求等进行交互。

特性

  • 只读访问 到所有GitHub REST API GET端点
  • Pydantic模型 用于类型安全请求有效载荷
  • 通用API客户端 具有全面的错误处理功能
  • 身份验证支持 通过GitHub个人访问令牌
  • 限速意识 以及正确的错误处理
  • 全面的端点覆盖 用于所有主要的GitHub API类别

安装

使用紫外线(推荐)

# Install uv if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh

# Clone and install
git clone <repository-url>
cd mcp-github-readonly
uv sync

使用pip

pip install mcp-github-readonly

配置

将您的GitHub个人访问令牌设置为环境变量:

export GITHUB_TOKEN="your_github_token_here"

或者创建一个 .env 文件:

GITHUB_TOKEN=your_github_token_here

用法

将服务器添加到MCP客户端配置中:

{
  "servers": {
    "github-readonly": {
      "command": "mcp-github-readonly"
    }
  }
}

支持的API类别

  • 仓库:存储库信息、内容、分支、发布
  • 问题:问题、评论、标签、里程碑
  • 拉取请求:PR、评论、评论
  • 用户:用户资料、组织、关注者
  • 组织:组织数据、成员、团队
  • 行动:工作流、运行、工件
  • 应用:GitHub应用程序信息
  • Git数据库:Git对象和引用

许可证

MIT许可证