MCP Advisor for Windsurf: Setup & Config

What you can do with MCP Advisor in Windsurf

Pick it to discover task-relevant MCP servers without knowing their names in advance.

• Get installation guidance for a discovered GitHub project
• Use optional local Meilisearch for recommendations

Before you start: MCP Advisor in Windsurf

• npx
• An MCP-compatible client

Stdio is the default. Local Meilisearch is optional; the README also describes SSE and REST interfaces.

MCP Advisor Windsurf configuration

1. Choose Windsurf configuration scope

   For MCP Advisor, open macOS/Linux: ~/.codeium/windsurf/mcp_config.json Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json. Merge into mcpServers; remote endpoints use serverUrl.

2. Add MCP Advisor to Windsurf

   Use the mcpadvisor entry below in mcpServers. Keep MCP Advisor's documented stdio connection fields and your other Windsurf entries.

3. Check MCP Advisor in Windsurf

   MCP Advisor: Refresh MCP in Windsurf settings and inspect Cascade’s tools.

{
  "mcpServers": {
    "mcpadvisor": {
      "command": "npx",
      "args": [
        "-y",
        "@xiaohui-wang/mcpadvisor"
      ],
      "env": {}
    }
  }
}

MCP Advisor tools available to Windsurf

MCP Advisor's stored tool list documents 2 tools; compare it with Windsurf's connected tool list, because the stored list is not a live check.

recommend-mcp-servers

After refreshing MCP Advisor in Windsurf settings, check Cascade's tool list for recommend-mcp-servers.

install-mcp-server

After refreshing MCP Advisor in Windsurf settings, check Cascade's tool list for install-mcp-server.

Provide installation guidance for a specified MCP server and GitHub URL.

MCP Advisor: full stored tool descriptions

Troubleshooting MCP Advisor in Windsurf

• Check npx @xiaohui-wang/mcpadvisor (Node.js/npm) on the machine running Windsurf's MCP integration for MCP Advisor; refresh MCP and inspect Cascade's tools.
• MCP Advisor uses stdio here: Windsurf must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: Registry API connectivity can affect search results
• Known limitation: Local Meilisearch adds a separate service to configure
• General Windsurf troubleshooting lives in the /clients/windsurf guide.

Frequently asked questions