Threejs-mcp

A Three.js code-generation MCP server.

Tools

Related MCP server: maige-3d-mcp

Prerequisites

• Python 3.13+

• uv

Installation

Clone this repository, then update the path in run.sh to point to the cloned directory:

#!/bin/zsh
source ~/.zshrc
exec uv run --directory /path/to/threejs-mcp threejs-mcp

Make the script executable:

chmod +x run.sh

Then follow the instructions for your MCP client below. Replace /path/to/threejs-mcp/run.sh with the actual path to the script.

Claude Code

claude mcp add threejs -s user -- /path/to/threejs-mcp/run.sh

The scope (-s) can be user, project, or local.

Claude Desktop

Open Settings > Developer > Edit Config and add to claude_desktop_config.json:

{
  "mcpServers": {
    "threejs": {
      "command": "/path/to/threejs-mcp/run.sh"
    }
  }
}

Cursor

Open Settings > MCP > Add new global MCP server and add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "threejs": {
      "command": "/path/to/threejs-mcp/run.sh"
    }
  }
}

Or add to .cursor/mcp.json in your project root for project-scoped configuration.

Windsurf

Open Settings > MCP > Add Server > Add custom server and add to your MCP config:

{
  "mcpServers": {
    "threejs": {
      "command": "/path/to/threejs-mcp/run.sh"
    }
  }
}

VS Code / GitHub Copilot

Add to your user or workspace settings.json:

{
  "mcp": {
    "servers": {
      "threejs": {
        "command": "/path/to/threejs-mcp/run.sh"
      }
    }
  }
}

Or create .vscode/mcp.json in your project root:

{
  "servers": {
    "threejs": {
      "command": "/path/to/threejs-mcp/run.sh"
    }
  }
}

Zed

Add to your Zed settings (~/.config/zed/settings.json):

{
  "context_servers": {
    "threejs": {
      "command": {
        "path": "/path/to/threejs-mcp/run.sh"
      }
    }
  }
}

Cline

Open Settings > MCP Servers > Edit MCP Settings and add to the config:

{
  "mcpServers": {
    "threejs": {
      "command": "/path/to/threejs-mcp/run.sh"
    }
  }
}

Continue

Add to your ~/.continue/config.yaml:

mcpServers:
  - name: threejs
    command: /path/to/threejs-mcp/run.sh

Roo Code

Open Settings > MCP > Edit MCP Settings and add:

{
  "mcpServers": {
    "threejs": {
      "command": "/path/to/threejs-mcp/run.sh"
    }
  }
}

Any other MCP client

This is a standard stdio MCP server. Run it with:

/path/to/threejs-mcp/run.sh

Scraping docs

The docs/ directory contains condensed markdown scraped from the Three.js documentation. To regenerate:

uv run python scrape_docs.py

This requires the httpx and beautifulsoup4 packages (not included in the main dependencies).