中級読了 4 分

DynamoDB MCP サーバー: Claude Code、Cursor、Codex

Model Context Protocol (MCP) を使うと、ターミナルやエディタで動く AI エージェント(Claude Code、Cursor、Codex、VS Code Copilot)が、推測する代わりに外部のツールを呼び出せます。

一つを DynamoDB に向ければ、エージェントはスキーマを読み取り、実際の読み取りを実行し、編集を提案できます。テーブルのダンプをチャットに貼り付ける必要はありません。

重要なのは何を渡すかです。エージェントを DynamoDB に配線するほとんどの方法は、MCP サーバープロセスにあなたの AWS 認証情報を渡します。その認証情報でできることは、汚染された行やプロンプトインジェクションされたドキュメントに操られたエージェントにもできてしまいます。

DynamoDB の MCP サーバーはありますか?

はい、複数あります。AWS はデータモデリング向けのサーバーと、ライブの AWS API 呼び出しを行う汎用サーバーを公開しています。コミュニティの npm・PyPI サーバーは読み取りを(一部は書き込みも)提供し、DynoTable はローカルの MCP サーバーとして動作します。選ぶべきは、エージェントにどれだけの権限を与えるかです。

  • エージェントに DynamoDB を読んで推論させたい? 背後の認証情報が読み取り専用であれば、ライブアクセスのあるどのサーバーでも機能します。方法はどのサーバーも読み取り専用で動かすにあります。
  • エージェントにデータを変更させたい? 直接の書き込み経路を渡してはいけません。人間がコミットするよう、書き込みをレビューステップ経由でルーティングしましょう。それが DynoTable のサーバーのやり方です。

選択肢の比較

サーバーライブのテーブルアクセス認証情報書き込み経路
AWS dynamodb-mcp-serverなし: モデリングと設計モデリングには不要なし
AWS MCP Server(AWS API MCP Server の後継)あり、あらゆる AWS API 呼び出しあなたの IAM 認証情報IAM ポリシーが許可するものすべて
コミュニティの npm/PyPI サーバーあり、ツールセットはさまざまサーバーの env にあるキーまたはプロファイル書き込み可能なサーバーでは直接
DynoTableあり、読み取り + ステージングした編集エージェントには渡されないステージングのみ。アプリ内であなたがコミット

AWS 公式の DynamoDB MCP サーバー: ライブ運用ではなくモデリング向け

AWS は awslabs/mcp で dynamodb-mcp-server を公開しています。2026-10-09 時点で、そのツールはデータモデリング、検証、コスト分析、コード生成を扱います。本番テーブルに対する読み取りや書き込みは実行しません。

AWS MCP Server: あなたの IAM ID によるライブ API 呼び出し

ライブのデータプレーンアクセスには、AWS の汎用サーバーがあなたの IAM 認証情報で AWS API 呼び出しを実行します。以前のローカル版 AWS API MCP Server は現在 "superseded by the official AWS MCP server" とされており、後継は IAM アクセス制御を備えたマネージドサーバーです。

ローカルの AWS API MCP Server を使う場合、READ_OPERATIONS_ONLY=true で読み取り操作に制限でき、REQUIRE_MUTATION_CONSENT=true で読み取り以外の呼び出しの前に確認を求めます(クライアントが elicitation に対応している必要があります)。

AWS の README は、主たる制御は引き続き IAM 権限であると付け加えています。

コミュニティの npm/PyPI サーバー

コミュニティ製の DynamoDB MCP サーバーはいくつもあります。テーブルとアイテムの全操作を公開するものもあれば、読み取りだけのものもあります。共通する形は次のとおりです:

  • あなたの AWS 認証情報はサーバーの環境に置かれます(.env、クライアント設定の env ブロック、または名前付きプロファイル)。その認証情報の IAM 権限がフルに効きます。
  • 接続ごとの同意も、スコープも、書き込みのステージングもありません。 読み取り専用のサーバーは書き込みツールを省くことであなたを守っているだけなので、本当の保証は背後の IAM ポリシーです。

どのサーバーも読み取り専用で動かす

どのサーバーを選んでも、認証情報を読み取り専用にすれば、サーバーが公開するツールやインジェクトされたプロンプトの要求にかかわらず、サーバーは書き込めません。

AWS マネージドポリシー AmazonDynamoDBReadOnlyAccess を専用のロールまたはユーザーにアタッチします。これは GetItem、BatchGetItem、Query、Scan、PartiQLSelect、Describe*、 List* を許可し、書き込みアクションは一切許可しません。

そのロール用の名前付きプロファイルを ~/.aws/config に追加します:

[profile dynamodb-readonly]
role_arn = arn:aws:iam::123456789012:role/DynamoDBReadOnly
source_profile = default
region = us-east-1

ロールの信頼ポリシーは、あなたの default ID がそのロールを引き受けることを許可している必要があります。

次に、サーバーの env ブロックでそのプロファイルを指定し、クライアント設定にキーを置かないようにします。ほとんどのサーバーは AWS_PROFILE を読みますが、AWS API MCP Server は AWS_API_MCP_PROFILE_NAME を読みます。Claude Code では:

claude mcp add --env AWS_API_MCP_PROFILE_NAME=dynamodb-readonly --env READ_OPERATIONS_ONLY=true \
  --transport stdio aws-api -- uvx awslabs.aws-api-mcp-server@latest

Cursor と Codex 向けの同じ env 設定は、それぞれのページにあります。

さらに絞り込むには、マネージドポリシーを、エージェントが必要とするテーブル ARN に限定したポリシーに置き換えます。

エージェント自身のシェルを AWS ファイルから遠ざける

エージェントにキーを渡さないサーバーでも、エージェントがキーを見つけることまでは防げません。あなたのプロファイルは ~/.aws にあり、読み取り専用ロールを引き受ける元になる default のキーもそこにあります。

Claude Code と Codex はあなたのユーザー権限でシェルコマンドを実行し、Cursor のエージェントターミナルも同じです。クライアント側でブロックしない限り、どれも ~/.aws/credentials を読んだり AWS CLI を実行したりできます:

  • Claude Code: Bash ツールをサンドボックス化して ~/.aws を拒否し、さらにファイルツール用に Read の拒否ルールを加えます(設定)。
  • Codex: パーミッションプロファイル(ベータ)で、Codex が実行するコマンドに対して ~/.aws のようなパスの読み取りを拒否できます(OpenAI のパーミッションのドキュメント)。
  • Cursor: ~/.cursor/sandbox.json に "readBoundary": "workspace" を設定します(Cursor 3.23 以降)。するとサンドボックス内のターミナルコマンドはワークスペースの外を読めなくなり、エージェントはそこにあるファイルを読む前に確認を求めます。サンドボックスの外で実行されたコマンドは対象外で、 Cursor のデフォルトの Auto-review 実行モードでは、その再実行を承認するのはあなたではなく分類器です。Allowlist 実行モード(Settings → Agents → Approvals & Execution)を使えば、それがあなたに回ってきます(設定、実行モード)。

MCP サーバーとしての DynoTable

DynoTable は、ローカルの MCP サーバーとして動作できるデスクトップの DynamoDB クライアントです。外部のエージェントがこれに接続すると、DynoTable の組み込みアシスタントが使うツールキットの一部を使えます。上記のサーバーとは 2 つの性質が異なります:

  • DynoTable はあなたの AWS 認証情報をエージェントに渡しません。 DynamoDB の呼び出しは DynoTable があなたのプロファイルで行い、エージェントは AWS ではなく DynoTable と対話します。それでもキーは ~/.aws にあるので、エージェントのシェルをそこから遠ざけましょう。
  • エージェントには DynamoDB に書き込むツールがありません。 エージェントが提案する変更はすべて DynoTable のステージングエリアに入り、コミットできるのはあなただけです。

サーバーはデフォルトでオフで、127.0.0.1 のみで待ち受けます。すべての接続はあなたが選んだスコープでクライアントごとに承認され、取り消し可能です。

これでプロンプトインジェクションが不可能になるわけではありません。操られたエージェントは、プロファイルが読めるものは何でも読み、それを繰り返せます。取り除かれるのは直接の書き込みです。

読み取りの範囲を限定するには、管理者プロファイルではなく、エージェントが必要とするテーブルだけを読める IAM ロールのプロファイル(どのサーバーも読み取り専用で動かすにあるような、テーブル ARN に限定した読み取りポリシー)だけを、エージェントが利用できるようにします。接続は、あなたが承認したプロファイルをそのまま使います。

有効化してクライアントを接続する

  1. プロファイルをエージェントが利用できるようにします。 DynoTable の設定でプロファイルの MCP セクションを開き、エージェントが利用可能をオンにします。利用できるプロファイルがなければ、すべての接続は拒否されます。同じスイッチで dynotable-cli もそのプロファイルを読み取れます。
  2. 設定 → MCP でサーバーをオンにします。ループバックポートにバインドされます。
  3. プロファイルの MCP セクションから接続スニペットをコピーします。実際のポートと ?profile=<slug> のヒントが含まれています。

Claude Code、Cursor、Codex にはそれぞれ、正確な設定、ログイン手順、そのクライアントでよくある間違いをまとめたウォークスルーがあります: Claude Code · Cursor · Codex。ウォークスルーのない 2 つのクライアントについては次のとおりです:

MCP: Open User Configuration を実行し、すべてのワークスペースから見えるユーザーの mcp.json (Copilot エージェントモード)に追加します。DynoTable のスニペットもここを指しており、コミット対象のワークスペースファイルである .vscode/mcp.json ではありません。VS Code のサーバー追加フローは、このユーザーファイルを互換性のために残している非推奨の保存先として挙げ、新しいサーバーにはポータブルな ~/.copilot/mcp-config.json(サーバーはトップレベルの mcpServers キーの下)を優先するよう勧めています。ユーザーの mcp.json も引き続き使えます:

{
  "servers": {
    "dynotable-prod": {
      "type": "http",
      "url": "http://127.0.0.1:<port>/mcp?profile=prod"
    }
  }
}

endpoint は OAuth で保護されています。初回使用時にクライアントがブラウザでのログインを開き、 DynoTable がクライアント名を示す同意プロンプトを表示します。

スコープ: 各許可で何ができるか

同意プロンプトは、どのスコープを付与するか、または拒否するかを尋ねます:

  • 読み取り専用: スキーマの読み取り、クエリの実行、アイテムの読み取り。変更はなし。
  • 読み取りとステージ: 上記に加えて、あなたがレビューしてコミットするための変更のステージング。フィルターに一致するアイテムの一括編集や一括削除のステージングも含みます。コミットするまで何も削除されません。
  • フルアクセス: 上記に加えて、ビューを開く、フィルターを設定する、エクスポートする。書き込みは引き続きステージングを経由します。

まずは読み取り専用から始めましょう。付与したスコープをその場で狭めることはできません。MCP ペインにあるのは失効とすべて失効で、失効したクライアントは次のリクエストで失敗します。クライアントのスコープを変えるには、失効させてから、再接続を希望のスコープで承認します。

有効なプランまたはトライアルがない場合、DynoTable は付与したスコープにかかわらず、すべての接続を読み取り専用に制限し(ステージングは拒否されます)、Workbench SQL ツールを非表示にします。料金を参照してください。

エージェントが実行できるもの

生の Query ツールや Scan ツールはありません。エージェントが読み取りに使うのは、PartiQL の SELECT(WHERE でパーティションキーを固定すると DynamoDB は Query として実行し、そうでなければ Scan として実行します)、GetItem、アイテム数のカウント、そして JOIN / GROUP BY 集計のための Workbench SQL です。

Workbench SQL の呼び出しは、WHERE が何であれ、SQL を実行する前に FROM のテーブルを丸ごとスキャンします。つまり集計 1 回にフルパス 1 回分(下記の金額)がかかります。ソートキーのないテーブルのパーティションキー、または GSI のうちちょうど 1 つだけのパーティションキーになっている属性での JOIN は、その側をキーで読み取ります。それ以外の結合は、ソートキーを持つテーブルのパーティションキーでの結合も含め、そのテーブルもスキャンします。アイテム数のカウントも Scan でページングします。MCP 経由では、 DynoTable は 1 回の呼び出しを 5,000 万アイテム、約 50 GB、または 30 分のスキャンで打ち切り、打ち切るまでに読んだ分は課金されます。

PartiQL の結果は 1 回の呼び出しあたり 10 行または 5 KB に制限されるので、エージェントがテーブルをコンテキストに丸ごと取り込むことはできません。全一覧は AI ツールのドキュメントにあります。

エージェントのクエリは DynamoDB でいくらかかるか

Scan は、フィルターが返すアイテムではなく、評価したすべてのアイテムに対して課金されます。 DynamoDB はアイテムサイズを合計し、次の 4 KB に切り上げ、オンデマンドテーブルの結果整合性読み取りでは 4 KB あたり 0.5 読み取りリクエストユニットを課金します。

50 GB のテーブルなら、フルパス 1 回でおよそ 655 万読み取りリクエストユニット(52,428,800 KB ÷ 4 × 0.5)、us-east-1 の定価(100 万あたり $0.125)で約 $0.82 です。探索しながら再スキャンするエージェントは、そのたびにこの額を支払います。

プロビジョニングされたテーブルでは、同じパスが RCU を消費し、アプリケーションの読み取りをスロットリングさせることがあります。

読み取り専用スコープが止めるのは書き込みであって、読み取りではありません。読み取り専用のエージェントでもテーブル全体をスキャンできます。読み取りコストを抑える制御は別のところにあります:

  • PartiQL でパーティションキーを固定します。 まずスキーマを尋ね、エージェントに WHERE でパーティションキーに = または IN を指定させれば、ステートメントは Query として実行されます。 AWS: "the WHERE clause condition must specify a partition key." これは Workbench SQL には当てはまりません。Workbench SQL はどのみち FROM のテーブルをスキャンします。

  • クライアントでこのサーバーの呼び出しごとの承認をオンのままにします。 そうすれば、各ステートメントや Workbench SQL の呼び出しが指定するテーブルを、実行前に確認できます。Cursor では、このサーバーのツールをリストから外したまま Allowlist 実行モードを使うことを意味します(Cursor ガイド)。デフォルトの Auto-review モードでは分類器が承認します。

  • テーブルのレートに上限を設けます。 オンデマンドテーブルに最大読み取りスループットを設定すると、それを超えるリクエストはスロットリングされます。制限されるのは合計ではなく 1 秒あたりのユニット数で、アプリケーションもスロットリングされるので、通常のピークより上に設定します。

  • IAM で PartiQL のフルスキャンを拒否します。 dynamodb:FullTableScan 条件を true にした dynamodb:PartiQLSelect への Deny (AWS の例)は、スキャンになる PartiQL の SELECT を拒否します。Scan API は対象外です。

  • エージェントがキーによる検索しか必要としないなら、最大級のテーブルで dynamodb:Scan を拒否します。エージェント専用に用意したロールで、それらのテーブル ARN に Deny を設定します。

    これが止めるのはフルパスだけではありません。そのテーブルを FROM に置いた Workbench SQL、アイテム数のカウント、そして Scan でアイテムをサンプリングするスキーマ取得(getSchema、 getSampleValues)も止まります。DynoTable 自身のテーブルビューもスキャンするので失敗します。

    describeTable は引き続きキーとインデックスを返し、キー指定の PartiQL、GetItem、そして GSI のうちちょうど 1 つだけのパーティションキーになっている属性(ソートキーがなければテーブル自身のパーティションキー)でそのテーブルに結合する JOIN は引き続き動作します。エージェントには必要な属性名を伝えておきましょう。

自分のテーブルでのフルパスは料金計算ツールで見積もれます。代替手段については Scan が遅くて高い理由を参照してください。

AI エージェントに DynamoDB アクセスを与えても安全か?

経路次第です。機微でないテーブルへの読み取りアクセスは、認証情報が読み取り専用であれば低リスクです。

決めるべきは書き込みアクセスです。自律的なエージェントに、認証情報と直接の書き込み経路の両方を与えてはいけません。読み取り専用に保つか、すべての変更を人間が承認するレビューステップ経由でルーティングしましょう。

DynoTable は後者を採ります。エージェントにキーを渡さず、書き込みツールも与えません。コミットはあなたがステージングエリアから行います。

MCP エージェントは私の DynamoDB テーブルに書き込めるか?

書き込み可能なサーバーと書き込み可能な認証情報なら、はい、直接書き込めます。読み取り専用の IAM プロファイルなら、いいえ。書き込みはアクセス拒否エラーで失敗します。

DynoTable では、直接には書き込めません。読み取りとステージまたはフルアクセスでは、エージェントは変更をステージングでき、それはレビュー可能な差分として表示され、あなたがコミットしたときにだけ書き込まれます。

製品名はそれぞれの所有者の商標であり、識別のためにのみ参照しています。AWS サーバーの詳細は 2026-10-09 に確認済みです。これらのサーバーは変化するので、ツール一覧に頼る前に awslabs リポジトリを再確認してください。

関連ページ

著者: Dmitriy · 更新日