MCP.so
Sign In

SurrealDB MCP Server

@nsxdavid

Repository

About SurrealDB MCP Server

No overview available yet

Basic information

Category

Other

License

NOASSERTION

Runtime

node

Transports

stdio

Publisher

nsxdavid

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "surrealdb": {
      "command": "npx",
      "args": [
        "-y",
        "surrealdb-mcp-server"
      ],
      "env": {
        "SURREALDB_URL": "",
        "SURREALDB_NS": "",
        "SURREALDB_DB": "",
        "SURREALDB_USER": "",
        "SURREALDB_PASS": ""
      }
    }
  }
}

Tools

10

Execute a raw SurrealQL query.

Select records from a table (all or by specific ID).

Create a single new record in a table.

Update a specific record, replacing its content.

Delete a specific record by ID.

Merge data into a specific record (partial update).

Apply JSON Patch operations to a specific record.

Create a record if it doesn't exist, or update it if it does.

Insert multiple records into a table.

Create a graph relation (edge) between two records.

Overview

What is SurrealDB MCP Server?

A Model Context Protocol server that provides a standardized interface for AI assistants to query and manipulate data within a SurrealDB database. It enables AI systems to perform CRUD operations and run SurrealQL queries against a configured SurrealDB instance.

How to use SurrealDB MCP Server?

Install globally via npm (npm install -g surrealdb-mcp-server) or run on-demand with npx -y surrealdb-mcp-server. Configure the server by setting five environment variables (SURREALDB_URL, SURREALDB_NS, SURREALDB_DB, SURREALDB_USER, SURREALDB_PASS) in your MCP host’s settings file, then restart the host and verify the server appears in the tool list.

Key features of SurrealDB MCP Server

  • Execute raw SurrealQL queries via the query tool.
  • Perform CRUD operations: select, create, update, delete, merge.
  • Use advanced operations: patch, upsert, insert, insertRelation.
  • Handles graph relation creation between records.
  • Connects to local or cloud SurrealDB instances via WebSocket.

Use cases of SurrealDB MCP Server

  • Allow an AI coding assistant to create, read, update, and delete records in a SurrealDB database.
  • Enable an AI chatbot to run custom SurrealQL queries for data analysis.
  • Let an AI agent insert bulk records or define graph edges between entities.

FAQ from SurrealDB MCP Server

What environment variables are required?

The server needs SURREALDB_URL, SURREALDB_NS, SURREALDB_DB, SURREALDB_USER, and SURREALDB_PASS to connect to a SurrealDB instance.

How do I verify the server is installed correctly?

Ask your MCP host (e.g., Claude, Cline) to “list available MCP servers” – “surrealdb” should appear. If not, check your configuration path and environment variables.

What if I see a “Cannot find module” error?

Ensure the package is globally installed (npm list -g surrealdb-mcp-server) and that the path in your MCP settings matches the actual installation location. Reinstall if needed.

Why am I getting a connection error?

Verify that SurrealDB is running (surreal start --log debug) and that the URL, namespace, database, and credentials are correct and reachable from the server host.

Can I use this server without a global install?

Yes. Using npx -y surrealdb-mcp-server as the command in your MCP configuration automatically downloads and runs the package without a permanent global install.

Comments

More Other MCP servers

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Mcp

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

Core Philosophy: Connect, Unify, Respond

mindsdb

Delegate anything. It comes back done.

39.4K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K