Transform OpenAPI definitions into MCP (Model Context Protocol) tools for seamless LLM-API integration
接入配置
选择客户端,复制配置,再按项目文档补齐环境变量。
claude mcp add openapi-bridge --env DEFINITIONS_DIRECTORY='<DEFINITIONS_DIRECTORY>' --env PORT='<PORT>' --env MOUNT_PATH='<MOUNT_PATH>' -- npx openapi-mcp-bridge --definitions ./api-definitions --port 3000~/.codex/config.toml
[mcp_servers.openapi-bridge]
command = "npx"
args = ["openapi-mcp-bridge", "--definitions", "./api-definitions", "--port", "3000"]
env = { DEFINITIONS_DIRECTORY = "<DEFINITIONS_DIRECTORY>", PORT = "<PORT>", MOUNT_PATH = "<MOUNT_PATH>" }
# codex mcp add openapi-bridge --env DEFINITIONS_DIRECTORY='<DEFINITIONS_DIRECTORY>' --env PORT='<PORT>' --env MOUNT_PATH='<MOUNT_PATH>' -- npx openapi-mcp-bridge --definitions ./api-definitions --port 3000~/.cursor/mcp.json
{
"mcpServers": {
"openapi-bridge": {
"command": "npx",
"args": [
"openapi-mcp-bridge",
"--definitions",
"./api-definitions",
"--port",
"3000"
],
"env": {
"DEFINITIONS_DIRECTORY": "<DEFINITIONS_DIRECTORY>",
"PORT": "<PORT>",
"MOUNT_PATH": "<MOUNT_PATH>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"openapi-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"openapi-mcp-bridge",
"--definitions",
"./api-definitions",
"--port",
"3000"
],
"env": {
"DEFINITIONS_DIRECTORY": "<DEFINITIONS_DIRECTORY>",
"PORT": "<PORT>",
"MOUNT_PATH": "<MOUNT_PATH>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"openapi-bridge": {
"command": "npx",
"args": [
"openapi-mcp-bridge",
"--definitions",
"./api-definitions",
"--port",
"3000"
],
"env": {
"DEFINITIONS_DIRECTORY": "<DEFINITIONS_DIRECTORY>",
"PORT": "<PORT>",
"MOUNT_PATH": "<MOUNT_PATH>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"openapi-bridge": {
"command": "npx",
"args": [
"openapi-mcp-bridge",
"--definitions",
"./api-definitions",
"--port",
"3000"
],
"env": {
"DEFINITIONS_DIRECTORY": "<DEFINITIONS_DIRECTORY>",
"PORT": "<PORT>",
"MOUNT_PATH": "<MOUNT_PATH>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"openapi-bridge": {
"command": "npx",
"args": [
"openapi-mcp-bridge",
"--definitions",
"./api-definitions",
"--port",
"3000"
],
"env": {
"DEFINITIONS_DIRECTORY": "<DEFINITIONS_DIRECTORY>",
"PORT": "<PORT>",
"MOUNT_PATH": "<MOUNT_PATH>"
}
}
}
}需要的环境变量
DEFINITIONS_DIRECTORYPORTMOUNT_PATH
把占位值换成你自己的密钥;不要把密钥提交到代码仓库。