广告合作
MCP.so
登录

Surreal MCP Server

@lfnovo

代码仓库

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

lfnovo

提交者

Luis Novo

关于 Surreal MCP Server

MCP server for SurrealDB database

#surrealdb#mcp-server#ai-assistant

Surreal MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "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 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

点击上方按钮,在临时沙箱中运行此服务器并实时获取工具列表。

概览

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.

常见问题

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.

评论

其他 分类下的更多 MCP 服务器

der die das – German noun genders (Lingviko)

Lingviko

The article (der, die, das) of 90,000 German nouns, compounds included, plus a checker that finds wrong articles in German text (“mit der Zug” → dem). Uses dictionary data, not AI guessing. Free, no login.

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K
广告合作