python-sdk/docs/mcp/vscode.md

VS Code Integration

Set up hanzo-mcp with VS Code, Cursor, and other MCP-compatible editors.

VS Code with Continue

Continue is an open-source AI code assistant that supports MCP.

Installation

1. Install Continue extension from VS Code marketplace
2. Configure MCP in ~/.continue/config.json:

{
  "models": [...],
  "mcpServers": [
    {
      "name": "hanzo",
      "command": "uvx",
      "args": ["hanzo-mcp"]
    }
  ]
}

3. Restart VS Code

Cursor

Cursor has built-in MCP support.

Configuration

Add to Cursor settings (~/.cursor/mcp.json):

{
  "mcpServers": {
    "hanzo": {
      "command": "uvx",
      "args": ["hanzo-mcp", "--allow-path", "~"]
    }
  }
}

Windsurf (Codeium)

Configuration

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "hanzo": {
      "command": "uvx",
      "args": ["hanzo-mcp"]
    }
  }
}

Generic MCP Client

For any MCP-compatible client:

stdio Transport

{
  "command": "uvx",
  "args": ["hanzo-mcp", "--transport", "stdio"]
}

SSE Transport

Start the server:

hanzo-mcp --transport sse --port 8888

Connect to: http://localhost:8888/sse

Project-Specific Configuration

Create .hanzo/config.json in your project root:

{
  "name": "my-project",
  "rules": [
    "Use TypeScript",
    "Follow existing patterns"
  ],
  "enabled_tools": {
    "shell": true,
    "browser": false
  }
}

The MCP server will automatically detect and apply project settings.

Recommended Extensions

VS Code

• Continue - AI assistant with MCP support
• Claude Dev - Claude integration
• GitLens - Git integration (works well with hanzo tools)

Cursor

Built-in AI features work with hanzo-mcp out of the box.

Troubleshooting

Server Not Starting

# Check if hanzo-mcp is installed
uvx hanzo-mcp --version

# Test manually
uvx hanzo-mcp --transport sse --port 8888
# Then open http://localhost:8888 in browser

Permission Errors

Ensure paths are allowed:

{
  "args": ["hanzo-mcp", "--allow-path", "/path/to/project"]
}

Tool Not Available

Some tools require additional dependencies:

# Full installation with all tools
pip install hanzo-mcp[tools-all]

# Or specific tools
pip install hanzo-mcp[browser]  # Playwright
pip install hanzo-mcp[llm]      # LiteLLM

Logs and Debugging

For SSE transport, logs appear in terminal. For stdio:

# Redirect stderr to file
hanzo-mcp 2>/tmp/hanzo-mcp.log

Performance Tips

1. Use uvx - Faster startup than pip-installed version
2. Limit paths - Only allow necessary directories
3. Disable unused tools - Reduces memory usage
4. Use project config - Faster tool discovery

See Also

• Quickstart - Getting started
• Configuration - All configuration options
• Tools Reference - Available tools