Communitygithub.com

24601/surreal-skills

Habilidades MCP de SurrealDB para agentes de IA: servidor integrado (SurrealDB 3.1+ `surreal mcp`) y surrealmcp independiente (surrealdb/surrealmcp v0.4.0). Parte de la colección surreal-skills.

¿Qué es surreal-skills?

Este conjunto de habilidades proporciona dos superficies MCP (Model Context Protocol) para que los agentes de IA interactúen con bases de datos SurrealDB. La superficie integrada, disponible desde SurrealDB 3.1+, se accede mediante `surreal mcp` o el endpoint HTTP `/mcp`, y es ideal para entornos de desarrollo locales con la configuración más simple. La superficie independiente, `surrealmcp` (versión 0.4.0), ofrece un catálogo de herramientas extendido, ayudantes para la nube y capacidad de cambiar entre múltiples endpoints. Ambas superficies permiten a agentes como Claude Code, Cursor o Codex ejecutar consultas SurrealQL, administrar esquemas y realizar operaciones CRUD directamente sobre SurrealDB. Para usar la integrada, basta con configurar el host MCP para ejecutar `surreal mcp` con los parámetros de conexión; la independiente requiere instalar desde fuente o Docker y ejecutar el subcomando `start`. La documentación detallada sobre variables de entorno y herramientas se encuentra en el archivo de reglas adjunto.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/24601/surreal-skills/tree/main/skills/surrealmcp

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

SurrealDB MCP para Agentes de IA

Existen dos superficies MCP desde SurrealDB 3.1:

SuperficieCuándo usarla
Integrada (surreal mcp, HTTP /mcp)Hosts IDE locales; configuración más simple con el binario principal surreal
Independiente (surrealmcp start)Catálogo de herramientas extendido, ayudantes para la nube, conmutación de múltiples endpoints

MCP Integrado (SurrealDB 3.1+)

# stdio — configuración típica del host MCP
surreal mcp --endpoint ws://127.0.0.1:8000/rpc --ns test --db test \
  --user root --pass root

Seguridad: El MCP stdio concede acceso a nivel de propietario sin paso de inicio de sesión. No exponer a hosts no confiables. HTTP /mcp requiere autenticación normal de SurrealDB.

Consulta rules/surrealmcp.md para variables de entorno y sugerencias de herramientas.

Surrealmcp Independiente (v0.4.0)

No publicado en crates.io ni npm. Instalar desde fuente o Docker:

git clone https://github.com/surrealdb/surrealmcp
cd surrealmcp && cargo install --path .

# O Docker
docker run --rm -i --pull always surrealdb/surrealmcp:latest start \
  --endpoint ws://localhost:8000/rpc --ns test --db test

El subcomando start es obligatorio. Catálogo completo de herramientas y cableado del host: rules/surrealmcp.md.

Individual skills in this repo

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

Skills relacionados