MCP SurrealDB para Agentes de IA
Existem duas superfícies MCP a partir do SurrealDB 3.1:
| Superfície | Quando usar |
|---|---|
Embutido (surreal mcp, HTTP /mcp) | Hosts IDE locais; configuração mais simples com o binário principal surreal |
Autônomo (surrealmcp start) | Catálogo estendido de ferramentas, auxiliares de nuvem, troca de múltiplos endpoints |
MCP Embutido (SurrealDB 3.1+)
# stdio — configuração típica de host MCP
surreal mcp --endpoint ws://127.0.0.1:8000/rpc --ns test --db test \
--user root --pass root
Segurança: MCP stdio concede acesso a ferramentas de nível proprietário sem etapa de login. Não exponha
a hosts não confiáveis. HTTP /mcp requer autenticação normal do SurrealDB.
Consulte rules/surrealmcp.md para variáveis de ambiente e dicas de ferramentas.
Sobre o surrealmcp Autônomo (v0.4.0)
Não publicado no crates.io ou npm. Instale a partir do código-fonte ou Docker:
git clone https://github.com/surrealdb/surrealmcp
cd surrealmcp && cargo install --path .
# Ou Docker
docker run --rm -i --pull always surrealdb/surrealmcp:latest start \
--endpoint ws://localhost:8000/rpc --ns test --db test
O subcomando start é obrigatório. Catálogo completo de ferramentas e conexão com o host:
rules/surrealmcp.md.