GitHub组织数据协议服务器

一个将GitHub组织数据暴露给AI助手的MCP服务器,提供组织、仓库、问题等数据的查询功能。

  • by DavidLiedle
  • Rust
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 DavidLiedle/gitorg-mcp

使用说明

gitorg mcp

一个MCP(模型上下文协议)服务器,将GitHub组织数据暴露给AI助手。这封装了以下功能 gitorg 作为stdio传输上的MCP工具。

工具

工具 说明
list_orgs 列出用户的GitHub组织
list_repos 使用可选的组织过滤器和排序(星号/活动/名称/陈旧性)列出跨组织的存储库
find_stale 查找没有最近推送的仓库(默认值:60天阈值)
list_issues 列出各组织的未决问题(不包括PR)
get_stats 汇总统计数据:总存储库、星级、分叉、问题、顶级语言
get_overview 完整仪表板:统计数据+最近活动的仓库+过时的仓库+最近的问题

所有工具都带有注释 readOnlyHint: true --此服务器仅从GitHub读取数据。

设置

1.安装铁锈

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

2.建造

git clone https://github.com/DavidLiedle/gitorg-mcp.git
cd gitorg-mcp
cargo build --release

二进制文件将位于 target/release/gitorg-mcp.

3.配置GitHub Token

选项A:环境变量

export GITHUB_TOKEN=ghp_yourtoken

选项B:配置文件 (与分享 gitorg)

创建 ~/.config/gitorg/config.toml:

[auth]
token = "ghp_yourtoken"

[defaults]
orgs = ["myorg", "otherorg"]  # optional: limit to specific orgs

令牌需要 read:org 和 repo 范围。创建一个 github/设置/令牌.

MCP配置

克劳德代码

添加到您的Claude Code MCP设置中(.claude/settings.json 或通过 claude mcp add):

claude mcp add gitorg-mcp /path/to/gitorg-mcp/target/release/gitorg-mcp

或者将GitHub令牌作为环境变量传递:

claude mcp add gitorg-mcp -e GITHUB_TOKEN=ghp_yourtoken -- /path/to/gitorg-mcp/target/release/gitorg-mcp

克劳德桌面版

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上):

{
  "mcpServers": {
    "gitorg-mcp": {
      "command": "/path/to/gitorg-mcp/target/release/gitorg-mcp",
      "env": {
        "GITHUB_TOKEN": "ghp_yourtoken"
      }
    }
  }
}

工具详细信息

list_orgs

没有参数。返回经过身份验证的用户所属的所有组织。

list_repos

参数 类型 说明
org string(可选) 筛选到特定组织
sort string(可选) 排序顺序: activity (默认), stars, name, staleness

find_stale

参数 类型 说明
days number(可选) 无需推送即可视为过时的天数(默认值:60)
org string(可选) 筛选到特定组织

list_issues

参数 类型 说明
org string(可选) 筛选到特定组织

get_stats

参数 类型 说明
org string(可选) 筛选到特定组织

获取概览

参数 类型 说明
org string(可选) 筛选到特定组织
days number(可选) 过期存储库的天数阈值(默认值:60)

组织决议

当否 org 如果提供了参数,服务器将按以下顺序解析组织:

  1. defaults.orgs 从 ~/.config/gitorg/config.toml (如果设置)
  2. 认证用户所属的所有组织(通过GitHub API)

许可证

麻省理工学院