使用说明
OpenAPI MCP服务器
一种基于Cloudflare Workers的服务,可从任何OpenAPI模式定义端点动态创建MCP服务器。该服务器实现了与Prompteus、Claude和Cursor等工具的无缝集成。
该项目由以下团队积极开发 快速.
快速开始
- 安装依赖项:
npm install
- 在本地运行服务:
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
- 创建配置负载:
const payload = {
schemaUrl: 'https://petstore3.swagger.io/api/v3/openapi.json',
baseUrl: 'https://petstore3.swagger.io/api/v3'
};
- 转换为base64url格式:
const base64Payload = btoa(JSON.stringify(payload))
.replace(/=/g, '')
.replace(/\+/g, '-')
.replace(/\//g, '_');
- 构造MCP服务器URL:
http://localhost:8787/mcp/{base64Payload}
配置后,您可以使用此MCP服务器通过各种工具与PetStore API进行交互。可用操作包括:
- 列出宠物
- 添加新宠物
- 更新宠物信息
- 删除宠物
- 还有更多。..
MCP服务器自动处理OpenAPI模式,并为所有API交互提供一致的接口。
使用openapitomcp.com
为方便起见,我们提供了一个网络界面 openapitomcp.com 它会自动为您生成配置有效负载。
工具特定配置
快速
Prompteus通过MCP服务器集成提供了强大的工作流功能。您可以通过Call AI Model节点创建利用MCP服务器的复杂工作流:
- 导航到Prompteus中的MCP服务器页面
- 点击 导入MCP服务器 按钮
- 输入MCP服务器URL(例如。,
https://bridge.openapitomcp.com/mcp/{base64Payload}) - 点击 获取 验证并初始化服务器
- 可选择添加 友好名称 区分多个MCP服务器
- 选择所需 工具 和 资源 从可用选项中
- 点击 导入 完成设置
要在Neuron工作流中使用MCP服务器:
- 将呼叫AI模型节点添加到工作流中
- 在节点的设置中,从下拉列表中选择您的MCP服务器
- 您可以为单个工作流选择多个MCP服务器
- 所选工具和资源将可用于您的工作流程
光标
- 按
CTRL/CMD+Shift+J打开“设置” - 导航到MCP设置
- 选择“添加新的全局MCP服务器”
- 添加此配置:
{
"mcpServers": {
"linear": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8787/mcp/{base64Payload}"]
}
}
}
Visual Studio Code
- 按
CTRL/CMD+P并搜索“MCP:添加服务器” - 选择“命令(stdio)”
- 输入此配置:
npx mcp-remote http://localhost:8787/mcp/{base64Payload}
- 命名服务器(例如,“Linear”)
- 通过“MCP:列出服务器”激活服务器
帆板运动
- 按
CTRL/CMD+,打开设置 - 导航到“级联->MCP服务器”
- 选择“添加服务器->添加自定义服务器”
- 添加此配置:
{
"mcpServers": {
"linear": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8787/mcp/{base64Payload}"]
}
}
}
泽德
- 按
CMD+,打开设置 - 添加此配置:
{
"context_servers": {
"linear": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8787/mcp/{base64Payload}"]
},
"settings": {}
}
}
