Communitygithub.com

24601/surreal-skills

SurrealDB MCP for AI agents: 내장 서버(SurrealDB 3.1+ `surreal mcp`) 및 독립형 surrealmcp(surrealdb/surrealmcp v0.4.0). surreal-skills 컬렉션의 일부입니다.

surreal-skills란 무엇인가요?

이 기술은 AI 에이전트(예: Claude Code, Cursor, Codex)가 SurrealDB와 상호 작용할 수 있도록 하는 MCP(Model Context Protocol) 인터페이스를 제공합니다. SurrealDB 3.1 이상의 내장 MCP 서버(`surreal mcp`, HTTP `/mcp`)와 독립형 surrealmcp 바이너리(v0.4.0+) 두 가지 표면을 제공합니다. 로컬 IDE에서 간단한 설정이 필요한 경우 내장 서버를 사용하고, 확장된 도구 카탈로그, 클라우드 헬퍼, 다중 엔드포인트 전환이 필요할 경우 독립형 바이너리를 사용합니다. 이 기술은 환경 변수, 도구 힌트, 호스트 연결 방법을 포함한 전체 구성을 `rules/surrealmcp.md` 파일로 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/24601/surreal-skills/tree/main/skills/surrealmcp

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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.

관련 스킬