SurrealDB MCP Server

Example Use Cases

• 1

  Run arbitrary SurrealQL queries against a SurrealDB instance and return results to users or downstream workflows.

• 2

  Create, update, delete, or upsert records in a SurrealDB database as part of data-enrichment or automated CRUD workflows.

• 3

  Model and create graph relations (edges) between records or perform batched inserts and JSON Patch-style updates to existing records.

Description

This project implements an MCP server adapter for SurrealDB, providing tools (query, select, create, update, delete, merge, patch, upsert, insert, insertRelation) so AI agents can interact with a SurrealDB instance over a standardized protocol. It is designed to integrate with MCP-capable hosts and agents (Cline, Claude Desktop, GitHub Copilot, Roo Code, Windsurf, Cursor, and n8n) and is configurable via environment variables for connection details. The package is distributed via npm and licensed MIT, enabling local or global installation and local development builds. The README includes installation snippets and troubleshooting tips for common connectivity and deployment issues.