OpenAPI MCP服务器

一个基于Cloudflare Workers的服务,可从任何OpenAPI模式定义端点动态创建MCP服务器,实现与Prompteus、Claude和Cursor等工具的无缝集成。

  • by prompteus-ai
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 prompteus-ai/openapi-mcp-server

使用说明

OpenAPI MCP服务器

一种基于Cloudflare Workers的服务,可从任何OpenAPI模式定义端点动态创建MCP服务器。该服务器实现了与Prompteus、Claude和Cursor等工具的无缝集成。

该项目由以下团队积极开发 快速.

快速开始

  1. 安装依赖项:
npm install
  1. 在本地运行服务:
npm run dev

该服务将在 http://localhost:8787.

托管服务

我们提供此服务的免费、尽力托管版本,网址为 bridge.openapitomcp.com 网站地址:。此服务由Prompteus团队维护,可供公众使用。虽然我们努力保持高可用性,但请注意,这是按原样提供的,不保证正常运行时间或支持。

要使用托管服务,只需替换 http://localhost:8787 随着 https://bridge.openapitomcp.com 在下面的任何示例中。

运作原理

此服务充当MCP客户端和OpenAPI记录的API之间的无状态代理。它需要基本的端点配置,该配置在URL中作为base64url编码的JSON对象传递。

示例:PetStore API集成

让我们逐步连接到Swagger的PetStore API示例:

  • OpenAPI架构: 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'
};
  1. 转换为base64url格式:
const base64Payload = btoa(JSON.stringify(payload))
    .replace(/=/g, '')
    .replace(/\+/g, '-')
    .replace(/\//g, '_');
  1. 构造MCP服务器URL:
http://localhost:8787/mcp/{base64Payload}

配置后,您可以使用此MCP服务器通过各种工具与PetStore API进行交互。可用操作包括:

  • 列出宠物
  • 添加新宠物
  • 更新宠物信息
  • 删除宠物
  • 还有更多。..

MCP服务器自动处理OpenAPI模式,并为所有API交互提供一致的接口。

使用openapitomcp.com

为方便起见,我们提供了一个网络界面 openapitomcp.com 它会自动为您生成配置有效负载。

工具特定配置

快速

Prompteus通过MCP服务器集成提供了强大的工作流功能。您可以通过Call AI Model节点创建利用MCP服务器的复杂工作流:

  1. 导航到Prompteus中的MCP服务器页面
  2. 点击 导入MCP服务器 按钮
  3. 输入MCP服务器URL(例如。, https://bridge.openapitomcp.com/mcp/{base64Payload})
  4. 点击 获取 验证并初始化服务器
  5. 可选择添加 友好名称 区分多个MCP服务器
  6. 选择所需 工具 和 资源 从可用选项中
  7. 点击 导入 完成设置

要在Neuron工作流中使用MCP服务器:

  1. 将呼叫AI模型节点添加到工作流中
  2. 在节点的设置中,从下拉列表中选择您的MCP服务器
  3. 您可以为单个工作流选择多个MCP服务器
  4. 所选工具和资源将可用于您的工作流程

光标

  1. 按 CTRL/CMD+Shift+J 打开“设置”
  2. 导航到MCP设置
  3. 选择“添加新的全局MCP服务器”
  4. 添加此配置:
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8787/mcp/{base64Payload}"]
    }
  }
}

Visual Studio Code

  1. 按 CTRL/CMD+P 并搜索“MCP:添加服务器”
  2. 选择“命令(stdio)”
  3. 输入此配置:
npx mcp-remote http://localhost:8787/mcp/{base64Payload}
  1. 命名服务器(例如,“Linear”)
  2. 通过“MCP:列出服务器”激活服务器

帆板运动

  1. 按 CTRL/CMD+, 打开设置
  2. 导航到“级联->MCP服务器”
  3. 选择“添加服务器->添加自定义服务器”
  4. 添加此配置:
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8787/mcp/{base64Payload}"]
    }
  }
}

泽德

  1. 按 CMD+, 打开设置
  2. 添加此配置:
{ 
  "context_servers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8787/mcp/{base64Payload}"]
    },
    "settings": {}
  }
}