Communitygithub.com

24601/surreal-skills

为AI代理提供SurrealDB MCP支持:内置服务器(SurrealDB 3.1+ `surreal mcp`)和独立工具surrealmcp(surrealdb/surrealmcp v0.4.0)。属于surreal-skills系列。

surreal-skills 是什么?

该技能为AI代理(如Claude Code、Cursor、Codex等)提供与SurrealDB交互的MCP(模型上下文协议)接口。自SurrealDB 3.1起,提供两种使用方式:内置服务器通过`surrealmcp`命令或HTTP `/mcp`端点运行,适合本地IDE环境,配置简单;独立工具`surrealmcp`则提供更丰富的工具目录、云辅助功能和多端点切换能力。技能文档详细说明了两种方式的安装与配置方法,并推荐使用`surrealdb/surrealmcp` v0.4.0版本作为独立运行方式。此技能对需要构建AI驱动数据库应用的开发者非常有用,可让代理直接执行查询、模式操作等任务。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

面向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。

Individual skills in this repo

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

相关技能