Communitygithub.com

24601/surreal-skills

SurrealDB MCP for AIエージェント:組み込みサーバー(SurrealDB 3.1+ `surreal mcp`)とスタンドアロン版surrealmcp(surrealdb/surrealmcp v0.4.0)。surreal-skillsコレクションの一部です。

surreal-skills とは?

このスキルは、AIエージェントがSurrealDBと対話するためのModel Context Protocol(MCP)インターフェースを提供します。SurrealDB 3.1以降では、`surreal mcp`コマンドまたはHTTPエンドポイント`/mcp`を使用したビルトインMCPサーバーが利用可能で、ローカルIDE環境での簡単なセットアップに最適です。また、スタンドアロン版のsurrealmcp(v0.4.0)は、より拡張されたツールカタログ、クラウドヘルパー、複数エンドポイントの切り替えをサポートします。ビルトイン版はstdio経由で接続し、所有者レベルのアクセス権限を持つため、信頼できないホストに公開しないでください。HTTP `/mcp`は通常のSurrealDB認証を必要とします。スタンドアロン版はソースまたはDockerからインストールでき、`start`サブコマンドが必須です。詳細なツールカタログや環境変数設定は、リンク先のルールファイルを参照してください。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

AIエージェントのためのSurrealDB MCP

SurrealDB 3.1時点で、2つの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。

Individual skills in this repo

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

関連スキル