Advertise
MCP.so
Sign In

Surreal MCP Server

@lfnovo

Repository

Basic information

Category

Other

Last updated

License

MIT

Transports

stdio

Author

lfnovo

Submitted by

Luis Novo

About Surreal MCP Server

MCP server for SurrealDB database

#surrealdb#mcp-server#ai-assistant

Surreal MCP Server config

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

{
  "mcpServers": {
    "surrealdb": {
      "command": "uvx",
      "args": [
        "surreal-mcp"
      ],
      "env": {
        "SURREAL_URL": "ws://localhost:8000/rpc",
        "SURREAL_USER": "root",
        "SURREAL_PASSWORD": "root",
        "SURREAL_NAMESPACE": "test",
        "SURREAL_DATABASE": "test"
      }
    }
  }
}

Surreal MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Surreal Mcp?

Surreal Mcp is a Model Context Protocol server that enables AI assistants to interact with SurrealDB databases by providing a standardized interface for executing SurrealQL queries, performing CRUD operations, managing graph relationships, and handling bulk operations.

How to use Surreal Mcp?

Install and run via uvx surreal-mcp (no installation needed) or using uv/pip after cloning the repository. Configure required environment variables (SURREAL_URL, SURREAL_USER, SURREAL_PASSWORD) and optionally set a default namespace and database. Add the server to your MCP client configuration (e.g., Claude Desktop) with the appropriate command and environment variables.

Key features of Surreal Mcp

  • Full SurrealQL query execution
  • Comprehensive CRUD create, read, update, delete operations
  • Graph database relationship creation and traversal
  • Bulk multi-record inserts
  • Smart updates: full replace, merge, and JSON Patch
  • Type-safe handling of SurrealDB RecordIDs
  • Connection pooling for efficient database management
  • Multi-database support via namespace/database override per tool call

Use cases of Surreal Mcp

  • Let an AI assistant query and update user records based on natural language requests.
  • Build and traverse graph relationships (e.g., "user purchased product") with simple tool calls.
  • Perform complex SurrealQL queries that the AI formulates from a description.
  • Run bulk inserts or updates across multiple records in one operation.
  • Manage data in separate namespaces/databases from a single session.

Frequently asked questions

1

What prerequisites are needed to run Surreal Mcp?

Python 3.10 or higher, a running SurrealDB instance (local or remote), and an MCP-compatible client (e.g., Claude Desktop, MCP CLI).

2

How do I configure database connection settings?

Set environment variables `SURREAL_URL`, `SURREAL_USER`, and `SURREAL_PASSWORD` (required) plus optional `SURREAL_NAMESPACE` and `SURREAL_DATABASE`. These can be overridden per tool call by passing `namespace` and `database` parameters.

3

What tools does Surreal Mcp provide?

It provides ten tools: `query`, `select`, `create`, `update`, `delete`, `merge`, `patch`, `upsert`, `insert`, and `relate`, each documented with example usage.

4

Can I work with multiple databases in one session?

Yes. By providing `namespace` and `database` parameters in individual tool calls, you can operate on different databases without needing multiple server instances.

5

How is connection management handled?

The server uses connection pooling (with SurrealDB Python SDK) and async/await for non-blocking database operations, with a pooled connection for the default environment and separate connections for overrides.

Comments

More Other MCP servers

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Arsen MCP

Arsen Security

Run advanced phishing, voice phishing, deepfake fraud simulations, and cybersecurity awareness training from your AI assistant.

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

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

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K
Advertise