広告掲載
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.

コメント

「その他」の他のコンテンツ

ICSS

chokcoco

不止于 CSS

20.7K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K
広告掲載