Communitygithub.com

24601/surreal-skills

SurrealDB MCP 給 AI 代理:內建伺服器 (SurrealDB 3.1+ `surreal mcp`) 與獨立 surrealmcp (surrealdb/surrealmcp v0.4.0)。屬於 surreal-skills 系列的一部分。

surreal-skills 是什麼?

此技能為 AI 代理提供兩個與 SurrealDB 互動的 MCP (Model Context Protocol) 介面,均支援 SurrealDB 3.1 及更新版本。第一個是內建於 SurrealDB 二進位檔中的 `surreal mcp`,以及 HTTP `/mcp` 端點,最適合在本機 IDE 環境中使用,設定簡單。第二個是獨立的 `surrealmcp` 工具 (v0.4.0),提供更豐富的工具目錄、雲端輔助功能以及多端點切換能力,適合需要擴展功能的進階場景。內建 MCP 使用 stdio 傳輸時會授予所有者等級的完全存取權限,因此不應暴露給不受信任的主機;而 HTTP 端點則需要正常的 SurrealDB 身分驗證。獨立版本需從 GitHub 原始碼或 Docker 映像安裝,並透過其 `start` 子命令啟動。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/24601/surreal-skills/tree/main/skills/surrealmcp

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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。

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

相關技能