Dynobase

dynobase-mcp

このパッケージを使うと、Claude Desktop、Codex、Windsurf など、stdio MCP サーバーのみを起動する AI ツールを、Amazon DynamoDB 用デスクトップクライアントである Dynobase に組み込まれた MCP サーバーに接続できます。

Dynobase 3.0 以降では、お使いのマシン上で Model Context Protocol サーバーを実行できます。AI ツールはこのサーバーを使って、テーブルの一覧表示、スキーマの読み取り、Dynobase が読み込んだ AWS プロファイルを通じたデータのクエリを実行できます。書き込みを許可しない限り、読み取り専用です。Claude Code と Cursor は HTTP 経由で直接接続できます。

このパッケージは、それ以外のすべてのクライアントを接続するブリッジです。標準入力から MCP メッセージを読み取り、Dynobase に転送して、応答を標準出力に書き込みます。依存関係はありません。

ブリッジは MIT ライセンスです。Dynobase 自体は、7 日間の無料トライアルがある有料アプリです。

要件

• Dynobase 3.0 以降を起動し、Settings → AI → MCP server をオンにしていること
• Node.js 18 以降。Claude Desktop 拡張機能では、Claude Desktop が macOS と Windows に Node.js を同梱しているため不要です。

セットアップ

Dynobase で MCP サーバーをオンにしてから、ブリッジをクライアントに追加します。ブリッジは Dynobase の設定からポートとトークンを読み取るため、クライアントの設定にトークンを含める必要はありません。

Claude Desktop 拡張機能：最新リリースから .mcpb ファイルをダウンロードして開きます。Claude Desktop にインストールダイアログが表示されます。トークンと URL のフィールドは空のままにしてください。

Claude Desktop（手動設定）、Windsurf、および mcpServers ファイルを使用するその他のクライアント

{
  "mcpServers": {
    "dynobase": {
      "command": "npx",
      "args": ["-y", "github:Dynobase/dynobase-mcp"]
    }
  }
}

Codex（~/.codex/config.toml）

[mcp_servers.dynobase]
command = "npx"
args = ["-y", "github:Dynobase/dynobase-mcp"]

Claude Code もブリッジで動作します。

claude mcp add dynobase -- npx -y github:Dynobase/dynobase-mcp

Claude Code と Cursor は、ブリッジを介さずに HTTP 経由で Dynobase に直接接続することもできます。そのための設定例は、Dynobase の設定セクションに表示されます。

ターミナルから接続をテストするには、次のようにします。

npx -y github:Dynobase/dynobase-mcp --check

オプション

フラグ	環境変数	デフォルト
--url <url>	DYNOBASE_MCP_URL	http://127.0.0.1:<port>/mcp。Dynobase に保存されているポートを使用します（変更していない場合は 41961）。
--token <token>	DYNOBASE_MCP_TOKEN	Dynobase の設定に保存されているトークン

フラグは環境変数より優先され、環境変数は Dynobase の設定より優先されます。

Dynobase は設定を ~/.dynobase に保存します。DYNOBASE_DATA_DIR が設定されている場合は、その場所に保存します。たとえば、クライアントが別のユーザーとして実行されているなどの理由でブリッジがそのフォルダーを読み取れない場合は、トークンを明示的に指定してください。

AI ツールでできること

次の読み取りツールは常に利用できます。

ツール	機能
list_profiles	読み込まれたプロファイルと、そのリージョンおよびテーブル名を一覧表示します
list_tables	1 つのプロファイルのテーブル名を一覧表示します
describe_table	TTL を含む DescribeTable の全出力を返します
scan	Scan の 1 ページ分を返します
query	Query の 1 ページ分を返します
get_item	プライマリキーを使って 1 つの項目を返します
partiql	PartiQL ステートメントを 1 つ実行します。書き込みが許可されていない場合は SELECT のみです
explain_query	キー条件で使用されるインデックスと、それが Query か Scan かを示します

書き込みツールは put_item、update_item、delete_item、batch_write および PartiQL の書き込みです。Dynobase で Allow writes をオンにした後にのみ使用できます。Dynobase は MCP クライアントによる各書き込みを項目の履歴に記録するため、元に戻せます。PartiQL の書き込みは例外で、元に戻せません。

各呼び出しで最大約 1 MB の項目が返され、60 秒後にタイムアウトします。ツールはこのパッケージではなく、インストールされている Dynobase のバージョンから提供されます。

セキュリティ

• Dynobase の MCP サーバーは 127.0.0.1 のみで待ち受けます。Host ヘッダーがループバック名でないリクエストは拒否します。
• すべてのリクエストにベアラートークンが必要です。ブリッジは独自の設定フォルダーからトークンを読み取り、設定された URL にのみ送信し、ログには記録しません。
• 書き込みを許可しない限り、サーバーは読み取り専用です。
• AWS の認証情報は Dynobase 内に保持されます。クライアントに表示されるのはツールの結果のみです。

トラブルシューティング

npx -y github:Dynobase/dynobase-mcp --check を実行すると、検出された内容が表示されます。ブリッジはログを stderr に出力し、ほとんどのクライアントでは MCP ログに表示されます。

• 「Dynobase に接続できません」：Dynobase を開き、Settings → AI → MCP server がオンになっていることを確認してください。ポートを変更した場合、--url または DYNOBASE_MCP_URL を設定していない限り、ブリッジは設定から新しいポートを読み込みます。
• 「Dynobase で MCP server がオフになっています」：Settings → AI → MCP server でオンにしてください。
• 「Dynobase にトークンを拒否されました」：トークンが再生成されています。--token または DYNOBASE_MCP_TOKEN を更新するか、これらを削除して、ブリッジが設定から現在のトークンを読み込むようにしてください。

仕組み

標準入力の各行は、1 つの JSON-RPC メッセージです。ブリッジは Authorization: Bearer <token> を付けて、Dynobase の Streamable HTTP エンドポイントに POST します。その後、応答内の各 JSON-RPC メッセージを 1 行ずつ標準出力に書き込みます。応答は JSON またはイベントストリームで、リクエストは並列に実行されます。

接続拒否やトークン拒否など、Dynobase が応答する前に発生するエラーもあります。ブリッジは、修正方法を説明する JSON-RPC エラーとしてそれらを返します。

ライセンス

MIT。Dynobase は別の商用製品です：https://dynobase.dev