mcpField
A
Apis Guru

Apis Guru

远程服务
pipeworx.io开发工具06 天前更新

关于 Apis Guru

Apis Guru 是一款 MCP 服务,用于探索 APIs.guru 的公共 API 目录及其 OpenAPI 规范。它帮助开发者发现 API、查看提供方目录并获取规范链接。

主要功能

  1. 01搜索公共 API
  2. 02获取 API 目录条目
  3. 03浏览 API 提供方
  4. 04查看目录统计

适用场景

  1. 01查找特定领域的 API
  2. 02获取 API 规范链接
  3. 03按提供方浏览 API
  4. 04查看目录覆盖统计

MCP 相关

向 MCP 客户端提供 APIs.guru 目录搜索、API 详情、提供方列表和统计数据。可通过 Pipeworx 网关端点或本地 stdio 服务运行。

配置

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

服务地址https://gateway.pipeworx.io/apis-guru/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 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

45
参数类型必填说明
qstring否question 的别名。
askstring否question 的别名。
textstring否question 的别名。
inputstring否question 的别名。
packsarray否可选。将路由限制为这些包的 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(绝不会返回空答案)。
querystring否question 的别名。
promptstring否question 的别名。
messagestring否question 的别名。
questionstring是用自然语言表达的问题或请求。支持 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

评论

支持 Markdown

第一次接触 MCP?

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

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