mcp-bridge
Description
The mcp-bridge Plugin bridges an HTTP client speaking the Model Context Protocol (MCP) over SSE to a stdio-based MCP server. APISIX spawns the configured command as a backend process and relays messages between the SSE connection and the process’s standard input and output.
WARNING
The mcp-bridge Plugin is deprecated and will be removed in a future release. We recommend not using it for new deployments.
Attributes
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| command | string | True | Command used to launch the MCP server process, e.g. npx. | |
| args | array[string] | False | Arguments passed to the command. | |
| base_uri | string | False | "" | Base URI used to build the SSE and message endpoint paths. |
Example usage
Create a Route with the mcp-bridge Plugin, pointing command and args at the MCP server you want to expose:
curl "http://127.0.0.1:9180/apisix/admin/routes" -X PUT \
-H "X-API-KEY: ${admin_key}" \
-d '{
"id": "mcp-route",
"uri": "/mcp/*",
"plugins": {
"mcp-bridge": {
"base_uri": "/mcp",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/"]
}
}
}'An MCP client can then connect to the SSE endpoint at /mcp/sse and exchange messages through /mcp/message.