Windsurf Integration

This guide walks you through setting up Distill with Windsurf IDE.

Prerequisites

• Windsurf installed (download)
• Node.js 18+ installed

Quick Setup (30 seconds)

npm install -g distill-mcp
distill-mcp setup --windsurf

Done! Restart Windsurf and you're ready.

Manual Setup

If the automatic setup didn't work, edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "distill": {
      "command": "distill-mcp",
      "args": ["serve"]
    }
  }
}

Or with npx (no global install):

{
  "mcpServers": {
    "distill": {
      "command": "npx",
      "args": ["distill-mcp", "serve"]
    }
  }
}

Verify Installation

Restart Windsurf, then ask:

List the MCP tools available

Using Distill with Windsurf

Smart File Analysis

Use smart_file_read to analyze src/components/Button.tsx

Log Summarization

Summarize these server logs: [paste logs]

Error Deduplication

When you have repeated errors:

Deduplicate these errors: [paste build output]

Troubleshooting

MCP Not Loading

1. Check the config file location: ~/.windsurf/mcp.json
2. Validate JSON syntax
3. Run distill-mcp doctor to check installation

Permission Errors

On macOS, you may need to allow the terminal in System Preferences > Security & Privacy.