McpMux
Back to Registry

SurrealDB (Docker) MCP Server

Community

Contributed by SurrealDB

Connect to a SurrealDB instance or Surreal Cloud via Docker. Run SurrealQL queries, manage records, inspect namespaces and databases, and explore schemas through the official SurrealDB MCP server in an isolated container.

Install with McpMuxSource CodeDocs

About the SurrealDB (Docker) MCP Server

The SurrealDB (Docker) MCP server is a local (stdio) Model Context Protocol server available in the McpMux registry. Connect to a SurrealDB instance or Surreal Cloud via Docker. Run SurrealQL queries, manage records, inspect namespaces and databases, and explore schemas through the official SurrealDB MCP server in an isolated container. This is a community-contributed MCP server by SurrealDB.

Install the SurrealDB (Docker) MCP server with one click using McpMux. It works with Cursor, Claude Desktop, Claude Code, VS Code, ChatGPT, Windsurf, JetBrains, and any MCP-compatible AI client. This server requires authentication — McpMux securely stores your credentials with AES-256-GCM encryption.

Transport Configuration

Transport Configuration
{
  "type": "stdio",
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "SURREALDB_URL",
    "-e",
    "SURREALDB_NS",
    "-e",
    "SURREALDB_DB",
    "-e",
    "SURREALDB_USER",
    "-e",
    "SURREALDB_PASS",
    "-e",
    "SURREAL_MCP_CLOUD_ACCESS_TOKEN",
    "surrealdb/surrealmcp:latest",
    "start"
  ],
  "env": {
    "SURREALDB_URL": "${input:SURREALDB_URL}",
    "SURREALDB_NS": "${input:SURREALDB_NS}",
    "SURREALDB_DB": "${input:SURREALDB_DB}",
    "SURREALDB_USER": "${input:SURREALDB_USER}",
    "SURREALDB_PASS": "${input:SURREALDB_PASS}",
    "SURREAL_MCP_CLOUD_ACCESS_TOKEN": "${input:SURREAL_MCP_CLOUD_ACCESS_TOKEN}"
  },
  "metadata": {
    "inputs": [
      {
        "id": "SURREALDB_URL",
        "label": "SurrealDB Endpoint URL",
        "description": "SurrealDB connection endpoint. Use host.docker.internal instead of localhost to reach a SurrealDB instance running on the host from inside Docker (e.g., ws://host.docker.internal:8000/rpc).",
        "type": "text",
        "required": false,
        "secret": false,
        "placeholder": "ws://host.docker.internal:8000/rpc"
      },
      {
        "id": "SURREALDB_NS",
        "label": "Namespace",
        "description": "The SurrealDB namespace to connect to.",
        "type": "text",
        "required": false,
        "secret": false,
        "placeholder": "mynamespace"
      },
      {
        "id": "SURREALDB_DB",
        "label": "Database",
        "description": "The SurrealDB database to connect to.",
        "type": "text",
        "required": false,
        "secret": false,
        "placeholder": "mydatabase"
      },
      {
        "id": "SURREALDB_USER",
        "label": "Username",
        "description": "The SurrealDB username to authenticate with.",
        "type": "text",
        "required": false,
        "secret": false,
        "placeholder": "root"
      },
      {
        "id": "SURREALDB_PASS",
        "label": "Password",
        "description": "The SurrealDB password to authenticate with.",
        "type": "text",
        "required": false,
        "secret": true,
        "placeholder": "********"
      },
      {
        "id": "SURREAL_MCP_CLOUD_ACCESS_TOKEN",
        "label": "Surreal Cloud Access Token",
        "description": "Surreal Cloud access token, used instead of username/password to connect to a Surreal Cloud instance. Leave empty for a self-hosted SurrealDB instance.",
        "type": "text",
        "required": false,
        "secret": true,
        "placeholder": "********",
        "obtain": {
          "url": "https://surrealdb.com/cloud",
          "instructions": "1. Sign in to Surreal Cloud\n2. Open your instance settings\n3. Generate or copy an access token\n4. Paste it here",
          "button_label": "Open Surreal Cloud"
        }
      }
    ]
  }
}
Details
TransportLocal (stdio)
Hostinglocal
Authoptional_api_key
Capabilities
ToolsResourcesPrompts

Categories

Database

Tags

surrealdbdatabasesurrealqlmulti-modelgraphdocker

Links

RepositoryHomepageDocumentation

Supported AI Clients

The SurrealDB (Docker) MCP server works with all MCP-compatible AI clients through McpMux:

CursorClaude DesktopClaude CodeVS CodeChatGPTWindsurfJetBrainsZedClineGemini CLIAmazon Q

Related MCP Servers

MongoDB (Docker)

Connect to MongoDB databases and Atlas clusters via Docker. Query collections, inspect schemas, manage indexes, and run aggregation pipelines in an isolated container.

MongoDB (npx)

Connect to MongoDB databases and Atlas clusters. Query collections, inspect schemas, manage indexes, and run aggregation pipelines through the official MongoDB MCP server.

PostgreSQL (Docker)

Query PostgreSQL databases, analyze performance, and optimize indexes via Docker. Execute SQL, inspect schemas, get EXPLAIN plans, identify slow queries, and run health checks.

PostgreSQL (uvx)

Query PostgreSQL databases, analyze performance, and optimize indexes. Execute SQL, inspect schemas, get EXPLAIN plans, identify slow queries, and run health checks via Postgres MCP Pro.

Redis (Docker)

Interact with Redis databases via Docker. Execute commands, manage keys, and work with data structures across standalone, cluster, and Sentinel modes.

Redis (uvx)

Interact with Redis databases. Execute commands, manage keys, and work with data structures across standalone, cluster, and Sentinel modes.

Install SurrealDB (Docker) with McpMux

One-click install from the McpMux desktop app. Auto-configures for Cursor, Claude, VS Code, ChatGPT, Windsurf, JetBrains, and any MCP-compatible client.

Install