使用说明
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 如果提供了参数,服务器将按以下顺序解析组织:
defaults.orgs从~/.config/gitorg/config.toml(如果设置)- 认证用户所属的所有组织(通过GitHub API)
许可证
麻省理工学院