SurrealDB MCP 給 AI 代理
截至 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。