OpenAPI MCP Server

OpenAPI MCP 服务

这是一个基于 Cloudflare Workers 的服务，可根据任意 OpenAPI schema 定义端点动态创建 MCP 服务。该服务可与 Prompteus、Claude 和 Cursor 等工具无缝集成。

此项目由 Prompteus 团队积极开发。

快速开始

1. 安装依赖项：

npm install

2. 在本地运行服务：

npm run dev

服务将在 http://localhost:8787 上提供。

托管服务

我们提供此服务的免费托管版本，尽力维护，地址为 bridge.openapitomcp.com。该服务由 Prompteus 团队维护，可供公众使用。我们会尽力保持服务的高可用性，但请注意，此服务按现状提供，不保证正常运行时间或提供支持。

如需使用托管服务，只需在以下任一示例中将 http://localhost:8787 替换为 https://bridge.openapitomcp.com。

工作原理

此服务充当 MCP 客户端与采用 OpenAPI 文档描述的 API 之间的无状态代理。它需要基本的端点配置，该配置以 base64url 编码的 JSON 对象形式传入 URL。

示例：集成 PetStore API

下面介绍如何连接到 Swagger 的示例 PetStore API：

• OpenAPI schema：https://petstore3.swagger.io/api/v3/openapi.json
• API 基础 URL：https://petstore3.swagger.io/api/v3

1. 创建配置负载：

const payload = {
    schemaUrl: 'https://petstore3.swagger.io/api/v3/openapi.json',
    baseUrl: 'https://petstore3.swagger.io/api/v3'
};

2. 转换为 base64url 格式：

const base64Payload = btoa(JSON.stringify(payload))
    .replace(/=/g, '')
    .replace(/\+/g, '-')
    .replace(/\//g, '_');

3. 构造 MCP 服务 URL：

http://localhost:8787/mcp/{base64Payload}

配置完成后，你便可以使用此 MCP 服务，通过各种工具与 PetStore API 交互。可用操作包括：

• 列出宠物
• 添加新宠物
• 更新宠物信息
• 删除宠物
• 以及更多……

MCP 服务会自动处理 OpenAPI schema，并为所有 API 交互提供一致的接口。

使用 openapitomcp.com

为了方便使用，我们提供了一个位于 openapitomcp.com 的 Web 界面，可自动为你生成配置负载。

工具专属配置

Prompteus

Prompteus 提供强大的工作流功能，并支持集成 MCP 服务。你可以通过 Call AI Model 节点创建利用 MCP 服务的复杂工作流：

1. 在 Prompteus 中前往 MCP Servers 页面
2. 点击 Import MCP Server 按钮
3. 输入 MCP 服务 URL（例如，https://bridge.openapitomcp.com/mcp/{base64Payload}）
4. 点击 Fetch 以验证并初始化服务
5. 可选：添加 Friendly Name，以便区分多个 MCP 服务
6. 从可用选项中选择所需的 Tools 和 Resources
7. 点击 Import 完成设置

如需在 Neuron 工作流中使用 MCP 服务：

1. 在工作流中添加 Call AI Model 节点
2. 在节点设置中，从下拉菜单选择你的 MCP 服务
3. 一个工作流可以选择多个 MCP 服务
4. 所选工具和资源将在工作流中可用

Cursor

1. 按 CTRL/CMD+Shift+J 打开设置
2. 前往 MCP 设置
3. 选择 “Add new global MCP server”
4. 添加以下配置：

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8787/mcp/{base64Payload}"]
    }
  }
}

Visual Studio Code

1. 按 CTRL/CMD+P 并搜索 “MCP: Add Server”
2. 选择 “Command (stdio)”
3. 输入以下配置：

npx mcp-remote http://localhost:8787/mcp/{base64Payload}

4. 为服务命名（例如，“Linear”）
5. 通过 “MCP: List Servers” 启用服务

Windsurf

1. 按 CTRL/CMD+, 打开设置
2. 前往 “Cascade -> MCP servers”
3. 选择 “Add Server -> Add custom server”
4. 添加以下配置：

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8787/mcp/{base64Payload}"]
    }
  }
}

Zed

1. 按 CMD+, 打开设置
2. 添加以下配置：

{ 
  "context_servers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8787/mcp/{base64Payload}"]
    },
    "settings": {}
  }
}