Is there any tutorial available for using mcp-bridge with Apache APISIX?

[elvus]

Currently, there is limited official documentation or tutorials specifically for mcp-bridge. Is there any guide for this?

[dosubot[bot]]

Hi @elvus! I'm Dosu and I’m helping the apisix team.

There is currently no comprehensive official tutorial dedicated specifically to using the mcp-bridge plugin with Apache APISIX. However, there are several resources that provide useful guidance and technical background:

• The mcp-bridge plugin is available in the master branch of APISIX and is still under development. It enables you to convert stdio-based MCP servers to HTTP SSE-based services, making it possible to manage and route these services through APISIX. You need to use the master branch to access this plugin, as it is not yet in a stable release [discussion].

• A detailed blog post, "From stdio to HTTP SSE: Hosting MCP Server with API Gateway", explains the architecture, features, and integration points of the mcp-bridge plugin. It covers how the plugin manages subprocesses, handles stdio, wraps MCP RPC calls as SSE streams, and supports session management. The post also describes how to enhance security and scalability by combining mcp-bridge with APISIX's authentication and rate-limiting plugins [blog].

• The GitHub discussion thread on using mcp-bridge with APISIX outlines practical steps: install APISIX, enable the mcp-bridge plugin, configure your MCP server as a subprocess, set up SSE streaming, manage sessions, and integrate with APISIX features like authentication and rate limiting.

If you need implementation details, you can also review the pull request introducing mcp-bridge, which contains code, test cases, and technical notes.

While there is no step-by-step tutorial, these resources collectively provide a solid foundation for experimenting with and deploying mcp-bridge in APISIX. If you need more specific configuration examples or run into issues, the discussion thread and blog post are good places to start.

To reply, just mention my name @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}