Communitygithub.com

24601/surreal-skills

MCP SurrealDB pour agents IA : serveur intégré (SurrealDB 3.1+ `surreal mcp`) et surrealmcp autonome (surrealdb/surrealmcp v0.4.0). Fait partie de la collection surreal-skills.

Qu'est-ce que surreal-skills ?

Cette compétence fournit deux interfaces MCP (Model Context Protocol) pour interagir avec SurrealDB depuis des agents IA comme Claude Code, Cursor ou Codex. Depuis SurrealDB 3.1, elle propose à la fois un serveur MCP intégré via `surreal mcp` ou le point de terminaison HTTP `/mcp`, idéal pour les hôtes IDE locaux avec une configuration minimale, et un serveur autonome `surrealmcp` qui offre un catalogue d'outils étendu, des assistants cloud et la possibilité de basculer entre plusieurs points de terminaison. Le mode stdio du serveur intégré accorde un accès de niveau propriétaire sans étape de connexion, tandis que le point de terminaison HTTP `/mcp` nécessite l'authentification normale de SurrealDB. Le serveur autonome s'installe depuis les sources ou Docker, et la commande `start` est obligatoire. Cette compétence est utile pour les développeurs qui souhaitent exécuter des requêtes SurrealDB, gérer des bases de données ou automatiser des workflows directement depuis leur agent IA, en utilisant les variables d'environnement et les conseils d'outils documentés dans les fichiers de règles associés.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

SurrealDB MCP pour Agents IA

Deux surfaces MCP existent depuis SurrealDB 3.1 :

SurfaceQuand l'utiliser
Intégré (surreal mcp, HTTP /mcp)Hôtes IDE locaux ; configuration la plus simple avec le binaire principal surreal
Autonome (surrealmcp start)Catalogue d'outils étendu, assistants cloud, commutation multi-points de terminaison

MCP Intégré (SurrealDB 3.1+)

# stdio — configuration typique de l'hôte MCP
surreal mcp --endpoint ws://127.0.0.1:8000/rpc --ns test --db test \
  --user root --pass root

Sécurité : MCP stdio accorde un accès de niveau propriétaire aux outils sans étape de connexion. Ne pas exposer à des hôtes non fiables. HTTP /mcp nécessite l'authentification normale de SurrealDB.

Voir rules/surrealmcp.md pour les variables d'environnement et les conseils d'outils.

surrealmcp Autonome (v0.4.0)

Non publié sur crates.io ou npm. Installez à partir des sources 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

La sous-commande start est obligatoire. Catalogue d'outils complet et câblage de l'hôte : rules/surrealmcp.md.

Individual skills in this repo

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

Skills associés