MCP Evolution API Supergateway
About
MCP Evo Supergateway is gateway application to interface with the Evolution API. It sets up an stdio MCP server defined in index.js and exposes it as a server-sent events (SSE) endpoint, making it ideal for remote connections or integration with tools like n8n.
Details
- Author
- brunonuzzi
- GitHub stars
- 1
- Downloads
- 181
- Categories
- Developer Tools
Jump to
- Gateway between Evolution API and MCP clients
- Exposes stdio MCP server as SSE endpoint
- Ready-to-run Docker container
- Configurable via environment variables
- Designed for remote connections and n8n integration
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP Evolution API SupergatewayCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, build the Docker image with docker build --pull --rm -f 'Dockerfile' -t 'mcp-evo-supergateway:latest' '.', then run the container with docker run -it --rm -p 8000:8000 mcp-evo-supergateway:latest. Set the environment variables EVOLUTION_APIKEY, EVOLUTION_INSTANCE, and EVOLUTION_API_BASE before running. Access the SSE endpoint at http://localhost:8000/sse.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp evolution api supergateway": {
"evo-mcp": {
"command": "docker",
"args": [
"build",
"--pull",
"--rm",
"-f",
"Dockerfile",
"-t",
"mcp-evo-supergateway:latest",
"."
]
}
}
}
}McpServers
{
"evo-mcp": {
"command": "docker",
"args": [
"build",
"--pull",
"--rm",
"-f",
"Dockerfile",
"-t",
"mcp-evo-supergateway:latest",
"."
]
}
}MCP Evolution API Supergateway
MCP Evo Supergateway is gateway application to interface with the Evolution API.
It sets up an stdio MCP server defined in index.js and exposes it as a server-sent events (SSE) endpoint, making it ideal for remote connections or integration with tools like n8n.
Getting Started
To get started, first clone this repository:git clone https://github.com/brunonuzzi/evo-mcp.git
cd mcp-evo-supergateway
Building the Docker Image
To build the Docker image for this repository, run the following command:docker build --pull --rm -f 'Dockerfile' -t 'mcp-evo-supergateway:latest' '.'
Running the Docker Container
To run the Docker container, use the following command:docker run -it --rm -p 8000:8000 mcp-evo-supergateway:latest
Environment Variables
The application requires the following environment variables to be set: -EVOLUTION_APIKEY=: Your API key for the Evolution service.
- EVOLUTION_INSTANCE=: The instance identifier for the Evolution service.
- EVOLUTION_API_BASE=: The base URL for the Evolution API.
Accessing the MCP SSE Server
Once the container is running, you can access the application at:http://localhost:8000/sse
Testing the Application
To test the application, run the following command:npx @modelcontextprotocol/inspector
http://localhost:8000/sse
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
