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.