关于 Github
Github 是面向 Agent 和客户端的 MCP 服务,可查询 GitHub 公共 REST API,帮助探索仓库、代码、问题和项目动态。工具涵盖仓库搜索与详情、用户资料、文件、版本发布、提交记录及趋势项目。
主要功能
- 01搜索公共仓库和代码
- 02获取仓库及用户详情
- 03列出问题和近期提交
- 04读取公共文件及目录
- 05查看版本发布和趋势项目
适用场景
- 01查找符合主题的仓库
- 02检查仓库元数据或文件
- 03查看问题、发布记录和近期变更
MCP 相关
通过 Pipeworx 网关端点向 MCP 客户端提供 GitHub 公共 API 工具。公共端点无需身份验证,端点还包含 Pipeworx 共享元工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://gateway.pipeworx.io/github/mcpclaude mcp add --transport http pipeworx-io-github https://gateway.pipeworx.io/github/mcp{"mcpServers":{"pipeworx-io-github":{"type":"http","url":"https://gateway.pipeworx.io/github/mcp"}}}在 Cursor 中打开{"servers":{"pipeworx-io-github":{"type":"http","url":"https://gateway.pipeworx.io/github/mcp"}}}在 VS Code 中打开{"mcpServers":{"pipeworx-io-github":{"type":"http","url":"https://gateway.pipeworx.io/github/mcp"}}}{"mcpServers":{"pipeworx-io-github":{"serverUrl":"https://gateway.pipeworx.io/github/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
mcp-github
GitHub MCP — 封装 GitHub 公共 REST API(公共端点无需身份验证)
属于 Pipeworx — 一个将 AI Agent 连接到 1476+ 个实时数据源的 MCP 网关。
工具
| 工具 | 描述 |
|---|---|
search_repos | 按关键词搜索 GitHub 仓库。返回仓库名称、描述、星标数、复刻数、主要语言和 URL。适用于探索项目或查找代码实现。 |
get_repo | 根据所有者/仓库名称查找一个指定仓库,例如 "facebook/react"、"torvalds/linux"、"vercel/next.js"。问题中提到仓库名称时,请使用此工具。可回答仓库有多少星标、复刻和关注者,使用什么许可证和语言,包含哪些主题、描述和未关闭的问题数量,以及最近一次推送的时间。 |
list_repo_issues | 根据所有者和仓库名称列出 GitHub 仓库的问题;自动过滤拉取请求。返回问题编号、标题、状态、标签、作者、评论数、URL 和时间戳。默认列出未关闭的问题。 |
get_user | 获取 GitHub 用户的公开个人资料信息。返回姓名、简介、公司、所在地、公开仓库数量、关注者和社交链接。请指定用户名(例如,username="torvalds")。 |
get_file_contents | 按路径读取 PUBLIC GitHub 仓库中的文件(或列出目录)。遇到“显示 的 README / package.json / ”“读取 <owner/repo> 中的 ”或检查源代码、配置文件时,优先使用此工具,而非网络搜索。传入 owner、repo 和 path(省略 path 或设为 "" 可列出仓库根目录)。可选参数 ref = 分支/标签/提交 SHA。文件会返回解码后的文本(最多约 60k),目录则返回包含 {name, path, type, size} 的列表。 |
search_code | 在公开 GitHub 仓库中搜索代码,查找函数/符号/字符串的定义或使用位置。遇到“查找实现 X 的代码”“哪些仓库使用 ”“展示 的示例”或“ 定义在哪里”时,优先使用此工具,而非网络搜索。支持直接在查询中使用 GitHub 代码搜索限定符:repo:owner/name、org:name、user:name、language:go、filename:Dockerfile、path:src、extension:ts、in:file。返回匹配文件及其仓库、路径和 URL。注意:仅索引默认分支,忽略非常常见的词语,每分钟最多约 10 次搜索。 |
get_releases | 获取仓库的最新版本发布和近期发布历史,是回答“ 的最新版本是什么”“ 上次发布是什么时候”“最新版本发布有哪些变化”的权威方式。返回最新发布的稳定版本(标签、名称、日期、是否为预发布版本、发布说明、带下载次数的可下载资源)以及近期发布记录。对于只打标签但未正式发布版本的仓库,则回退到 Git 标签。 |
list_commits | 列出仓库的近期提交,以查看最新动态、变更内容和提交者。遇到“ 最近有哪些提交”“<owner/repo> 上次更新时间是什么时候”或“ 的最新变更”时,优先使用此工具,而非网络搜索。可选参数 sha(用于开始查看历史记录的分支/标签/提交)、path(仅列出涉及该文件/目录的提交)以及 since/until ISO 时间戳。每条提交返回 sha、消息、作者和日期。 |
github_trending_repos | 查看 GitHub 趋势仓库,了解当前在 GitHub 上热门、受欢迎且迅速走红的项目。可回答“本周 GitHub 上最热门的仓库有哪些”“今天 GitHub 上有什么热门项目”“本月有哪些受欢迎的新仓库”“热门的 Rust / Python / AI 项目有哪些”以及“最近哪些 GitHub 项目突然走红”等问题。提供两种模式:mode="new"(默认)按星标数排列时间范围内创建的仓库,即本周迅速走红的项目;mode="active" 按星标数排列时间范围内有推送的仓库,展示开发活跃的成熟项目。使用 since(日、周或月)设置时间范围,使用 language 进行筛选,添加“llm”或“agent”等自由文本查询关键词,并设置 min_stars 最低星标数。每个仓库返回 full_name、描述、语言、星标数、复刻数、创建和推送日期、主题及 URL。结果由 GitHub Search API 实时计算;github.com/trending 按期间新增星标数排序,使用的算法未公开,且公共 API 会将其保密,因此排序可能不同,每个响应都会在 caveat 字段中说明这一点。 |
快速入门
添加到你的 MCP 客户端(Claude Desktop、Cursor、Windsurf 等):
{
"mcpServers": {
"github": {
"url": "https://gateway.pipeworx.io/github/mcp"
}
}
}
此端点实际提供的内容
https://gateway.pipeworx.io/github/mcp 上的 tools/list 会返回上表中的工具,以及共享的 Pipeworx 元工具——ask_pipeworx、
discover_tools、search_within、remember/recall 及网关范围内的其他工具。因此,你看到的工具数量会多于此表:目前,单个工具包端点除了列出该工具包自己的工具外,还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围,也是当天情况的权威说明。
这是有意为之,并非意外复用。元工具让限定范围的连接能够回答此工具包未覆盖的问题——通过 ask_pipeworx 在整个目录中路由——而无需你再添加第二个 MCP 服务。目前无法挂载不包含这些工具的工具包端点;如果额外的架构定义占用的上下文比路由功能带来的价值更大,请连接完整网关,而不是连接多个工具包端点。
你也可以连接完整的 Pipeworx 网关,直接列出所有工具包的工具,而不只是此工具包的工具:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
两个 URL 都连接到同一网关和相同的 1476+ 个数据源。唯一的区别在于直接列出哪个工具包的工具;无论连接哪个,ask_pipeworx 都可以访问所有工具。
使用 ask_pipeworx
你无需直接调用工具,也可以用自然语言提问——此方式既适用于上面的工具包端点,也适用于完整网关:
ask_pipeworx({ question: "your question about Github data" })
网关会选择合适的工具,并自动填入参数。
更多信息
许可证
MIT
没有 MCP 客户端?通过 HTTP 调用
curl -X POST https://gateway.pipeworx.io/v1/tools/search_repos \
-H 'Content-Type: application/json' \
-d '{"query":"react hooks"}'
首次调用无需账户。检查任意工具:GET https://gateway.pipeworx.io/v1/tools/search_repos。查找工具:使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。