任意 OpenAPI MCP 服务器

“任意 OpenAPI” MCP 服务器能做什么？

“任意 OpenAPI” MCP 服务器是一款用于将 AI 助手（如 Claude）连接至任何公开 OpenAPI（Swagger）规范的外部 API 的工具。它支持针对大型 OpenAPI 文档的语义搜索，智能分块端点，实现快速发现与交互。AI 客户端可通过自然语言查询（如“列出产品”）发现相关 API 端点，立即获取完整端点文档，并直接从服务器执行 API 请求。该服务器非常适合将私有或大型 API 集成到 AI 工作流中，简化如数据库查询或自定义 API 集成等操作，无需频繁手动更新。

提示词列表

在可用文档或代码中未提及具体提示词模板。

资源列表

在可用文档或代码中未明示 MCP 资源。

工具列表

• custom_api_request_schema
  通过对 OpenAPI 规范进行语义搜索，发现相关 API 端点。该工具可根据自然语言查询分块暴露端点文档。
• custom_make_request
  针对选定端点执行 API 请求。让 AI 助手可直接与 API 交互，提交请求并获取响应。

本 MCP 服务器的应用场景

• 私有服务 API 集成
  只需提供 OpenAPI JSON URL，即可让 Claude 或其他助手无缝连接私有 API，实现对内部系统的安全动态交互。
• 快速端点发现
  利用内存型语义搜索（基于 FAISS 和 MiniLM-L3），即使在庞大复杂的 OpenAPI 文档中也能快速定位相关 API 端点。
• 自动化 API 请求执行
  让 AI 客户端不仅能发现端点，还能实际执行 API 请求，实现如产品上架、订单管理或用户查询等自动化工作流，无需额外工具。
• 端点文档上下文访问
  可即时获取特定端点文档，支持参数细节发现与用法，助力 AI 自动化。
• 与 Claude 桌面端或类似客户端集成
  专为 Claude MCP 客户端设计，可突破文档体积限制，让桌面 AI 应用能实际利用大型 API。

如何搭建

Windsurf

1. 确保已安装 Node.js 与 Windsurf。
2. 找到 Windsurf 配置文件。
3. 在 mcpServers 对象中添加 @any-openapi/mcp-server@latest 项。
4. 配置命令及必要环境变量（如 OPENAPI_JSON_DOCS_URL）。
5. 保存并重启 Windsurf，核查服务器是否正常出现。

示例 JSON：

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

API 密钥安全配置：

{
  "env": {
    "API_KEY": "${ANY_OPENAPI_API_KEY}"
  },
  "inputs": {
    "apiKey": "${ANY_OPENAPI_API_KEY}"
  }
}

Claude

1. 确认 Claude 支持 MCP 服务器集成。
2. 打开 MCP 服务器的设置或配置面板。
3. 按需插入服务器详情，包括命令和环境变量。
4. 保存更改并重启 Claude（如有需要）。
5. 确认服务器可被发现并激活。

示例 JSON：

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

Cursor

1. 安装 Cursor 并进入 MCP 服务器配置区。
2. 用 @any-openapi/mcp-server@latest 新增 MCP 服务器条目。
3. 按需设置 API 环境变量。
4. 保存配置并重启 Cursor。
5. 通过列出可用工具验证集成。

示例 JSON：

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

Cline

1. 打开 Cline 配置文件。
2. 添加 @any-openapi/mcp-server@latest 的 MCP 服务器配置。
3. 设置所需环境变量。
4. 保存并重启 Cline。
5. 确认服务器已列在活动 MCP 服务器中。

示例 JSON：

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

API 密钥安全配置：
如上所示，请使用环境变量避免泄露敏感凭据。

如何在流程中使用 MCP

在 FlowHunt 中使用 MCP

要将 MCP 服务器集成进 FlowHunt 工作流，先在流程中添加 MCP 组件，并与 AI 代理连接：

点击 MCP 组件以打开配置面板。在系统 MCP 配置区，以如下 JSON 格式插入您的 MCP 服务器信息：

{
  "any-openapi": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置完成后，AI 代理即可作为工具使用该 MCP 并访问全部功能。请记得将 “any-openapi” 替换为您 MCP 服务器的实际名称，并更换成正确的 URL。

概览

Roots 支持： 文档或代码未明确说明。

根据文档和上述梳理，该 MCP 服务器定位清晰，功能成熟，非常适合 API 集成与动态端点发现，但缺乏明确的提示词/资源示例与采样、roots 相关文档。其搭建及安全实践标准且易懂。

我们的看法

对于需要将大型或私有 API 集成到 AI 助手（尤其是 Claude）中的开发者来说，这款 MCP 服务器极为实用。它在语义端点发现和直接 API 执行方面非常强大，但如果有更多文档和资源定义会更好。整体而言，这是一个专注、可靠的服务器，但还未完全覆盖所有 MCP 功能示例。

评分：7/10

MCP 评分