mcpField
G
Github

Github

远程服务
pipeworx.io版本控制06 周前更新

关于 Github

Github 是面向 Agent 和客户端的 MCP 服务,可查询 GitHub 公共 REST API,帮助探索仓库、代码、问题和项目动态。工具涵盖仓库搜索与详情、用户资料、文件、版本发布、提交记录及趋势项目。

主要功能

  1. 01搜索公共仓库和代码
  2. 02获取仓库及用户详情
  3. 03列出问题和近期提交
  4. 04读取公共文件及目录
  5. 05查看版本发布和趋势项目

适用场景

  1. 01查找符合主题的仓库
  2. 02检查仓库元数据或文件
  3. 03查看问题、发布记录和近期变更

MCP 相关

通过 Pipeworx 网关端点向 MCP 客户端提供 GitHub 公共 API 工具。公共端点无需身份验证,端点还包含 Pipeworx 共享元工具。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://gateway.pipeworx.io/github/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;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。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。