emqx_mcp_gateway
About
The emqxmcpgateway is an EMQX plugin that acts as a gateway, enabling MCP clients using the MCP over MQTT protocol to interact with MCP servers using other protocols (HTTP, STDIO, or gRPC).
Details
- Author
- emqx
- Downloads
- 303
- Categories
- Developer Tools
Jump to
- Bridges MCP/MQTT clients to MCP servers via HTTP, STDIO, or gRPC.
- Configurable server name mapping using CSV conditions with Variform Expressions.
- Server name filters to restrict client access to allowed MCP servers.
- Role‑Based Access Control (RBAC) for MCP tools and resources.
- Automatic ACL enforcement derived from server names and filters.
- Supports variable substitution in server names from MCP metadata.
Configure the plugin by preparing CSV files for server name mapping (mcp_server_name.csv), server name filters (mcp_server_name_filter.csv), and RBAC (mcp_rbac.csv). Add STDIO or HTTP MCP servers to the EMQX configuration file using HOCON blocks. The gateway automatically sets ACLs based on the configuration.
emqx_mcp_gateway
The MCP Gateway is an EMQX plugin that enables MCP clients using the MCP over MQTT protocol to interact with MCP servers using other protocols.
┌────────────────┐
┌─MCP/HTTP──┼ MCP HTTP Server│
│ └────────────────┘
│
│
┌───────────────┐ │
┌──────────┐ │ │ │ ┌─────────────────┐
│MCP Client┼──MCP/MQTT────┼ Gateway ┼───┼─MCP/STDIO─┼ MCP STDIO Server│
└──────────┘ │ │ │ └─────────────────┘
└───────────────┘ │
│
│
│ ┌──────────────────┐
└─CALL/gRPC─┼ MCP Server Plugin│
└──────────────────┘
Configure MCP server names and server name filters
Configure the Server Name for MCP/MQTT Servers
The MCP gateway supports configuring broker suggested server names for MCP servers, this it to avoid server name conflicts and maintain a consistent naming convention across different MCP servers.
To configure the server names for MCP servers, prepare an mcp_server_name.csv file with the following content:
```csv
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





