-
Notifications
You must be signed in to change notification settings - Fork 13
Quickstart
Suppose your client configuration originally specifies an MCP server like this:
{
"mcpServers": {
"fetch": {
"command": "uvx",
"args": ["mcp-server-fetch"]
}
}
}To route requests through Minibridge (enabling SBOM checks, policy enforcement, etc.), update the entry:
{
"mcpServers": {
"fetch": {
"command": "minibridge",
"args": ["aio", "--", "uvx", "mcp-server-fetch"]
}
}
}-
minibridge aio: Invokes Minibridge in “all-in-one” mode, wrapping the downstream tool. -
uvx mcp-server-fetch: The original MCP server command, now executed inside Minibridge.
Important
Your client must be able to resolve the path of the binary.
If you see an error like MCP fetch: spawn minibridge ENOENT, set the command parameter above to the full path of minibridge (which minibridge will give you the full path).
Minibridge allows you to deploy your MCP Server using http/sse:
Caution
Running tools over the public network without any encryption or authentication is not secure. This page gives the overall communication process. We strongly recommend to read Enable TLS and Authentication before moving to production.
If your client supports the http/sse protocol (like Cursor, VSCode, etc.), just start Minibridge in http/sse mode like:
minibridge aio --listen 127.0.0.1:8000 -- uvx mcp-server-fetchThen configure your client to use http/sse like:
{
"mcpServers": {
"fetch": {
"url": "http://127.0.0.1:8000/sse"
}
}
}If the client doesn't support http/sse (like Claude Desktop), you can leverage Minibridge's tunneling feature by running it in Web Socket mode locally (without TLS). This mode consist of two parts:
-
frontend, this is where the client connect to usingstdio -
backend, this is where the frontend connect to the backend running the actual tool
Start the backend:
minibridge backend --listen 127.0.0.1:8080 -- uvx mcp-server-fetchUse the frontend:
Then configure your client to use Minibridge as a gateway:
{
"mcpServers": {
"fetch": {
"command": "minibridge",
"args": ["frontend", "--backend", "ws://127.0.0.1:8080/ws"]
}
}
}Congratulations, you have configured your Minibridge to communicate with another Minibridge over the network!