evolution-api-mcp

Name: evolution-api-mcp
Author: singleflo

singleflo

MCP server for one Evolution API (WhatsApp) instance: chats, history, sending, groups and configuration. Local (uvx) and hosted.

接入配置

选择客户端，复制配置，再按项目文档补齐环境变量。

一键添加到 Cursor 一键添加到 VS Code

本地运行

claude mcp add evolution-api --env EVOLUTION_API_URL='<EVOLUTION_API_URL>' --env EVOLUTION_INSTANCE_TOKEN='<EVOLUTION_INSTANCE_TOKEN>' -- uvx evolution-api-mcp

~/.codex/config.toml

[mcp_servers.evolution-api]
command = "uvx"
args = ["evolution-api-mcp"]
env = { EVOLUTION_API_URL = "<EVOLUTION_API_URL>", EVOLUTION_INSTANCE_TOKEN = "<EVOLUTION_INSTANCE_TOKEN>" }

# codex mcp add evolution-api --env EVOLUTION_API_URL='<EVOLUTION_API_URL>' --env EVOLUTION_INSTANCE_TOKEN='<EVOLUTION_INSTANCE_TOKEN>' -- uvx evolution-api-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "evolution-api": {
      "command": "uvx",
      "args": [
        "evolution-api-mcp"
      ],
      "env": {
        "EVOLUTION_API_URL": "<EVOLUTION_API_URL>",
        "EVOLUTION_INSTANCE_TOKEN": "<EVOLUTION_INSTANCE_TOKEN>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "evolution-api": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "evolution-api-mcp"
      ],
      "env": {
        "EVOLUTION_API_URL": "<EVOLUTION_API_URL>",
        "EVOLUTION_INSTANCE_TOKEN": "<EVOLUTION_INSTANCE_TOKEN>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "evolution-api": {
      "command": "uvx",
      "args": [
        "evolution-api-mcp"
      ],
      "env": {
        "EVOLUTION_API_URL": "<EVOLUTION_API_URL>",
        "EVOLUTION_INSTANCE_TOKEN": "<EVOLUTION_INSTANCE_TOKEN>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "evolution-api": {
      "command": "uvx",
      "args": [
        "evolution-api-mcp"
      ],
      "env": {
        "EVOLUTION_API_URL": "<EVOLUTION_API_URL>",
        "EVOLUTION_INSTANCE_TOKEN": "<EVOLUTION_INSTANCE_TOKEN>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "evolution-api": {
      "command": "uvx",
      "args": [
        "evolution-api-mcp"
      ],
      "env": {
        "EVOLUTION_API_URL": "<EVOLUTION_API_URL>",
        "EVOLUTION_INSTANCE_TOKEN": "<EVOLUTION_INSTANCE_TOKEN>"
      }
    }
  }
}

远程托管

claude mcp add --transport http evolution-api https://evolution-mcp.singleflo.com/mcp

~/.codex/config.toml

[mcp_servers.evolution-api]
url = "https://evolution-mcp.singleflo.com/mcp"

# codex mcp add evolution-api --url https://evolution-mcp.singleflo.com/mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "evolution-api": {
      "url": "https://evolution-mcp.singleflo.com/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "evolution-api": {
      "type": "http",
      "url": "https://evolution-mcp.singleflo.com/mcp"
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "evolution-api": {
      "httpUrl": "https://evolution-mcp.singleflo.com/mcp"
    }
  }
}

claude_desktop_config.json · Customize › Connectors › Add custom connector

{
  "mcpServers": {
    "evolution-api": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://evolution-mcp.singleflo.com/mcp"
      ]
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "evolution-api": {
      "url": "https://evolution-mcp.singleflo.com/mcp"
    }
  }
}

需要的环境变量

EVOLUTION_API_URL
EVOLUTION_INSTANCE_TOKEN

把占位值换成你自己的密钥；不要把密钥提交到代码仓库。

接入配置

本地运行

远程托管

需要的环境变量

相关推荐