面向AI代理的SurrealDB MCP
从 SurrealDB 3.1 开始,存在两种 MCP 接口:
| 接口 | 使用场景 |
|---|---|
内置 (surreal mcp,HTTP /mcp) | 本地 IDE 宿主;配合主 surreal 二进制文件,配置最简单 |
独立 (surrealmcp start) | 更丰富的工具目录、云辅助功能、多端点切换 |
内置 MCP (SurrealDB 3.1+)
# stdio — 典型的 MCP 宿主配置
surreal mcp --endpoint ws://127.0.0.1:8000/rpc --ns test --db test \
--user root --pass root
安全性: stdio MCP 授予所有者级别的工具访问权限,无需登录步骤。请勿暴露给不受信任的主机。HTTP /mcp 需要正常的 SurrealDB 身份验证。
有关环境变量和工具提示,请参阅 rules/surrealmcp.md。
独立 surrealmcp (v0.4.0)
未发布到 crates.io 或 npm。从源代码或 Docker 安装:
git clone https://github.com/surrealdb/surrealmcp
cd surrealmcp && cargo install --path .
# 或者使用 Docker
docker run --rm -i --pull always surrealdb/surrealmcp:latest start \
--endpoint ws://localhost:8000/rpc --ns test --db test
start 子命令是必需的。完整的工具目录和宿主接线方式:
rules/surrealmcp.md。