インスタントDBサーバーMCPサーバー

InstantDB と対話するための MCP サーバー。

このサーバーは、動的に読み込まれるスキーマと環境設定を使用してInstantDBにクエリを実行するための読み取り専用インターフェースを提供します。クエリを実行したり、事前定義されたパターンに基づいてクエリ例を取得したりするためのツールが含まれています。

特徴

ツール

• get_examples
  さまざまなカテゴリ (「basic_read」、「filtering」、「associations」など) の定義済みサンプルクエリを返します。

• クエリDB
  InstantDB に対して特定のクエリを実行します。クエリと説明的な名前パラメータが必要です。

• リストクエリ
  クエリ ID、名前、タイムスタンプ、構造などの詳細とともに、実行されたクエリの履歴を取得します。

• 戻りクエリ
  後で参照または実装するために、一意の ID で特定のクエリを取得します。

スキーマと環境の統合

• 提供されたプロジェクト ディレクトリ (例: instant.schema.ts、src/instant.schema.ts、app/instant.schema.ts) を基準とした共通ファイルの場所から InstantDB スキーマを動的に読み込みます。

• 環境変数の設定はプロジェクトの.envファイルから読み込まれます。必須の変数には以下のものがあります。

  • インスタントアプリID

  • インスタントアプリ管理者トークン

保留中の機能

• 一般的なファイルの場所から InstantDB 権限ファイルを動的に検出します。

Related MCP server: mysql-mcp-server

発達

依存関係をインストールします:

npm install

サーバーを構築します。

npm run build

自動リビルドを使用した開発の場合:

npm run watch

インストール

Claude Desktop でサーバーを使用するには、Claude Desktop の設定に次の構成を追加します。

macOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

構成例:

{
  "mcpServers": {
    "instantdb-server": {
      "command": "node",
      "args": ["/path/to/instantdb-server/build/index.js"],
      "env": {
        "INSTANT_APP_ID": "your_app_id",
        "INSTANT_APP_ADMIN_TOKEN": "your_admin_token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

デバッグ

MCP サーバー通信をデバッグするには、MCP インスペクターを使用します。

npm run inspector

インスペクターは、MCP サーバー操作を監視するためのツールにアクセスするための URL を提供します。