关于 Apis Guru
Apis Guru 是一款 MCP 服务,用于探索 APIs.guru 的公共 API 目录及其 OpenAPI 规范。它帮助开发者发现 API、查看提供方目录并获取规范链接。
主要功能
- 01搜索公共 API
- 02获取 API 目录条目
- 03浏览 API 提供方
- 04查看目录统计
适用场景
- 01查找特定领域的 API
- 02获取 API 规范链接
- 03按提供方浏览 API
- 04查看目录覆盖统计
MCP 相关
向 MCP 客户端提供 APIs.guru 目录搜索、API 详情、提供方列表和统计数据。可通过 Pipeworx 网关端点或本地 stdio 服务运行。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://gateway.pipeworx.io/apis-guru/mcpclaude mcp add --transport http pipeworx-io-apis-guru https://gateway.pipeworx.io/apis-guru/mcp{"mcpServers":{"pipeworx-io-apis-guru":{"type":"http","url":"https://gateway.pipeworx.io/apis-guru/mcp"}}}在 Cursor 中打开{"servers":{"pipeworx-io-apis-guru":{"type":"http","url":"https://gateway.pipeworx.io/apis-guru/mcp"}}}在 VS Code 中打开{"mcpServers":{"pipeworx-io-apis-guru":{"type":"http","url":"https://gateway.pipeworx.io/apis-guru/mcp"}}}{"mcpServers":{"pipeworx-io-apis-guru":{"serverUrl":"https://gateway.pipeworx.io/apis-guru/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
45| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| q | string | 否 | question 的别名。 |
| ask | string | 否 | question 的别名。 |
| text | string | 否 | question 的别名。 |
| input | string | 否 | question 的别名。 |
| packs | array | 否 | 可选。将路由限制为这些包的 slug(例如 ["sec-form-d","sec-13f"]),路由器随后只会从这些包中的工具进行选择。省略则使用默认的完整目录路由。Slug 可从 list_packs / search_packs / https://pipeworx.io/directory 获取;未列出或未知的 slug 会被忽略,并在 _meta.pack_scope.ignored 中列出。如果没有任何 slug 能匹配问题,则会在整个目录中路由,并设置 _meta.pack_scope.full_catalog:true(绝不会返回空答案)。 |
| query | string | 否 | question 的别名。 |
| prompt | string | 否 | question 的别名。 |
| message | string | 否 | question 的别名。 |
| question | string | 是 | 用自然语言表达的问题或请求。支持 query、q、prompt、text、input、ask、message 作为别名。 |
详细介绍
mcp-apis-guru
APIs.guru MCP — 收录 2,500 多个公共 API 及其 OpenAPI 规范的免密目录。https://apis.guru
这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1872 多个实时数据源的 MCP 网关。这是一个独立的非官方集成,与上游提供方无关联、未经其认可,也非由其发布。
工具
| 工具 | 描述 |
|---|---|
search_apis | 按自由文本查询搜索 APIs.guru 目录中的 2,500 多个公共 API。匹配 API 的名称/键、标题、描述和类别。返回匹配的 API 列表,每项包含名称(目录键,例如 "stripe.com" 或 "googleapis.com:calendar")、标题、截断后的描述、提供方、类别、首选版本、最近更新日期、文档链接以及 OpenAPI/Swagger 规范 URL。使用此工具可查找某个领域(支付、天气、地图等)有哪些公共 API,并获取传递给 get_api 的准确 name。 |
get_api | 按 API 在 APIs.guru 中的准确名称/键(例如 "stripe.com" 或 "googleapis.com:calendar")获取该 API 的完整目录条目。返回该 API 的所有版本及其信息(标题、描述、提供方、类别)、最近更新日期、文档链接、OpenAPI/Swagger 规范 URL(swaggerUrl JSON + swaggerYamlUrl YAML),以及首选版本。知道准确名称(来自 search_apis)后,使用此工具获取 API 的规范 URL。 |
list_providers | 列出 APIs.guru 目录中追踪的所有 API 提供方(如 "googleapis.com"、"azure.com"、"amazonaws.com" 等域名)。返回 { count, providers }。使用此工具可先按组织浏览目录,再深入查找具体提供方或 API。 |
get_metrics | 获取整个 APIs.guru 目录的汇总统计信息,例如 API、提供方、端点和规范的总数(numAPIs、numEndpoints、numSpecs 等)。使用此工具可大致了解目录对公共 API 的覆盖范围。 |
快速开始
添加到你的 MCP 客户端(Claude Desktop、Cursor、Windsurf 等):
{
"mcpServers": {
"apis-guru": {
"url": "https://gateway.pipeworx.io/apis-guru/mcp"
}
}
}
此端点实际提供的内容
https://gateway.pipeworx.io/apis-guru/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 都连接到同一个网关和同样的 1872 多个数据源。唯一的区别在于哪些工具包的工具会被直接列出;从任一端点都可以通过 ask_pipeworx 访问所有工具。
没有 MCP 客户端?通过 HTTP 调用
curl -X POST https://gateway.pipeworx.io/v1/tools/search_apis \
-H 'Content-Type: application/json' \
-d '{"query":"payments"}'
首次调用无需账户。查看任意工具:GET https://gateway.pipeworx.io/v1/tools/search_apis。查找工具:使用 POST https://gateway.pipeworx.io/v1/tools/search_packs,并传入 {"query":"..."}。
独立运行(无需网关账户)
此软件包也可作为本地 stdio MCP 服务运行,无需 Pipeworx 账户,也无需经过网关往返:
{
"mcpServers": {
"apis-guru": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-apis-guru"]
}
}
}
也可以直接运行,确认它能正常启动:
npx -y @pipeworx/mcp-apis-guru
它通过 stdin/stdout 使用 MCP 通信,并针对仅限此软件包的工具响应 initialize/tools/list/tools/call——不包含上方网关连接所添加的任何共享元工具。相同的源代码,相同的工具,无需 ask_pipeworx 路由。
使用 ask_pipeworx
你也可以用通俗的英语提问,而不是直接调用工具——这既适用于上方的软件包端点,也适用于完整网关:
ask_pipeworx({ question: "your question about Apis Guru data" })
网关会选择合适的工具并自动填写参数。
更多信息
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。