Communitygithub.com

24601/surreal-skills

SurrealDB MCP für KI-Agenten: eingebauter Server (SurrealDB 3.1+ `surreal mcp`) und eigenständiger surrealmcp (surrealdb/surrealmcp v0.4.0). Teil der surreal-skills-Sammlung.

Was ist surreal-skills?

Diese Fähigkeit stellt zwei MCP-Oberflächen (Model Context Protocol) für KI-Agenten bereit, um mit SurrealDB-Datenbanken zu interagieren: einen eingebauten Server ab SurrealDB 3.1 und einen eigenständigen Service `surrealmcp`. Der eingebaute Server wird über den Befehl `surreal mcp` oder den HTTP-Endpunkt `/mcp` gestartet und eignet sich ideal für lokale IDE-Hosts mit minimalem Setup. Der eigenständige Server `surrealmcp` bietet ein erweitertes Werkzeugverzeichnis, Cloud-Hilfsfunktionen und die Möglichkeit, zwischen mehreren Endpunkten zu wechseln. Er wird aus dem Quellcode installiert oder als Docker-Image (`surrealdb/surrealmcp`) ausgeführt. Beide Varianten von SurrealDB MCP ermöglichen KI-Agenten, Datenbankoperationen wie Abfragen, Schemaverwaltung und Datenmanipulation auf natürliche Weise durchzuführen, was die Entwicklung intelligenter Datenbankanwendungen erheblich vereinfacht.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

SurrealDB MCP für KI-Agenten

Es gibt zwei MCP-Oberflächen ab SurrealDB 3.1:

OberflächeVerwendungshinweis
Eingebaut (surreal mcp, HTTP /mcp)Lokale IDE-Hosts; einfachste Einrichtung mit der Haupt-surreal-Binärdatei
Eigenständig (surrealmcp start)Erweitertes Werkzeugverzeichnis, Cloud-Hilfsfunktionen, Multi-Endpunkt-Wechsel

Eingebauter MCP (SurrealDB 3.1+)

# stdio — typische MCP-Host-Konfiguration
surreal mcp --endpoint ws://127.0.0.1:8000/rpc --ns test --db test \
  --user root --pass root

Sicherheit: stdio MCP gewährt Besitzer-Zugriff auf Werkzeuge ohne Anmeldung. Nicht ungeprüften Hosts zugänglich machen. HTTP /mcp erfordert normale SurrealDB-Authentifizierung.

Siehe rules/surrealmcp.md für Umgebungsvariablen und Werkzeugtipps.

Eigenständiger surrealmcp (v0.4.0)

Nicht auf crates.io oder npm veröffentlicht. Aus dem Quellcode oder Docker installieren:

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

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

Der Unterbefehl start ist obligatorisch. Vollständiges Werkzeugverzeichnis und Host-Verdrahtung: rules/surrealmcp.md.

Individual skills in this repo

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

Verwandte Skills