菜单
Use when the user asks Claude to inspect, query, administer, or troubleshoot SurrealDB through the bundled Database MCP server — the user's own SurrealDB instance, reached over its built-in /mcp HTTP route.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when the user references Spectron, or when Spectron tools appear in the active toolset — this plugin connects Claude to a Spectron instance over its /mcp HTTP route.
Use after editing or writing any `.surql` file, or when the user asks Claude to format, lint, or check SurrealQL files.
Using SurrealDB with the Python SDK, covering both client/server mode (WebSocket) and embedded mode (in-memory or file-based). Use when connecting to SurrealDB from Python, using the surrealdb Python package, running SurrealDB embedded without a server, or performing CRUD operations from Python code. Triggers: surrealdb Python, Surreal(), AsyncSurreal(), Python SDK, embedded SurrealDB, mem://, file://.
Vector search with SurrealDB using HNSW indexes, KNN queries, and similarity scoring. Use when creating vector indexes, querying vectors with KNN distance operators, building semantic search or RAG pipelines, tuning HNSW parameters (EFC, M, M0, distance function, type), or implementing recommendation systems with SurrealDB. Triggers: HNSW, vector, embedding, KNN, cosine, euclidean, semantic search, RAG, vector::distance.
Generate and modify SurrealQL queries to interact with SurrealDB databases. This includes creating and retrieving records, designing and managing schemas, establishing and querying graph relationships, performing live (real-time) queries, and leveraging all unique SurrealQL features for advanced database workflows. Use this skill whenever users need to write, adapt, or troubleshoot SurrealQL statements.
| name | mcp |
| description | Use when the user asks Claude to inspect, query, administer, or troubleshoot SurrealDB through the bundled Database MCP server — the user's own SurrealDB instance, reached over its built-in /mcp HTTP route. |
This plugin wires up one MCP server in .mcp.json:
surrealdb-database — the data plane. Talks directly to the user's SurrealDB instance over its built-in /mcp HTTP route. Use it for inspecting schemas, running SurrealQL, reading/writing records, managing permissions, and everything else inside a namespace/database.| Task | Use |
|---|---|
| Run a SurrealQL query, inspect tables/fields, define schema, manage users/scopes, work with records | surrealdb-database |
The Database MCP URL is required — there is no default. Set it to your instance's /mcp endpoint, along with a bearer token, before launching Claude Code:
export SURREALDB_MCP_URL="https://my-host.example.com/mcp"
export SURREALDB_MCP_TOKEN="<bearer-token-or-jwt>"
SURREALDB_MCP_URL — full URL including the /mcp path (e.g. http://127.0.0.1:8000/mcp for a local instance, or https://<your-instance>/mcp for a remote one).SURREALDB_MCP_TOKEN — bearer token used to authenticate against the SurrealDB instance's /mcp route.If SURREALDB_MCP_URL is unset, the server won't connect — tell the user to export it and restart Claude Code.
A SurrealDB surreal-bearer-... grant key is not an HTTP auth token. If the user only has signin credentials (root user/pass, scope SIGNIN/SIGNUP), they must exchange those for an access token first.
Every MCP query and mutation tool runs against the user's real database. Before:
DELETE or bulk updatesDEFINE / REMOVE on tables, fields, indexes, scopes, accesses…state the intended change and confirm with the user. Read-only SELECT / INFO FOR queries do not need confirmation.
SELECT * FROM user LIMIT 5; against my database."post table with title and body fields and a published permission."