Dynamo Readonly MCP

🚀 DynamoDB 読み取り専用コンソール

DynamoDB 読み取り専用コンソールは、DynamoDB メッセージプロトコル (MCP) を利用したサーバーです。Claude のような大規模言語モデル (LLM) が自然言語クエリを通じて DynamoDB データにアクセスできるようにします。ユーザーは自然言語でリクエストを送信することで、DynamoDB テーブルの読み取り専用アクセスを取得できます。

✨ 主な機能

テーブル管理ツール

• すべてのテーブルをリストする (list-tables)：すべての DynamoDB テーブルの情報を返します。
• テーブルを説明する (describe-table)：指定されたテーブルの詳細情報を取得します。
• テーブルの存在チェック (table-exists)：指定されたテーブルが存在するかどうかを検証します。

データクエリツール

• 基本クエリ (query-table)：キー条件式を使ってテーブルデータをクエリします。
• 高度なクエリ (advanced-query)：複雑なフィルタリングとソート操作をサポートします。
• テーブルをスキャンする (scan-table)：テーブル内のすべての項目を返し、条件によるフィルタリングが可能です。

リソース管理

• テーブル情報リソース (dynamodb-tables-info)：すべてのテーブルのメタデータを提供します。
• 特定のテーブル構造 (dynamodb-table-schema)：指定されたテーブルのスキーマ情報を返します。
• インデックス詳細 (dynamodb-indexes-info)：テーブル内のすべてのインデックスとその設定をリストします。

プロンプトサポート

• クエリヘルプ (dynamodb-query-help)：有効な DynamoDB クエリの書き方に関するガイダンスを提供します。
• ベストプラクティスのヒント (best-practices-tip)：効率的なデータアクセス戦略を推奨します。
• エラー回復のヒント (error-recovery-tip)：エラーが発生した場合、推奨される修復手順を提供します。

📦 インストール

プロジェクトのクローン

Git を使ってリポジトリをクローンします：

git clone https://github.com/yourusername/dynamodb-read-only-console.git

環境依存のインストール

プロジェクトディレクトリに移動した後、必要な依存関係をインストールします：

npm install

環境変数の設定

.env ファイルを作成して編集します：

DYNAMODB_ENDPOINT=your-endpoint
DYNAMODB_REGION=your-region

サービスのビルドと起動

プロジェクトをビルドします：

npm run build

サーバーを起動します：

npm start

📚 ドキュメント

Claude Desktop への接続

clay.json ファイルに以下の設定を追加することで、Claude があなたの MCP サービスに接続できるようになります：

{
  "mcp": {
    "servers": [
      {
        "url": "http://localhost:3000",
        "options": {
          "keepalive": true,
          "family": 4
        }
      }
    ]
  }
}

💻 使用例

基本的な使用法

例1：すべてのテーブル情報を取得する

ユーザーがクエリを送信します： "すべての DynamoDB テーブルを表示して" Claude は list-tables ツールを呼び出し、以下の結果を返します：

[
  {
    "TableName": "Users",
    "TableStatus": "ACTIVE",
    "CreationDateTime": "2023-10-01T12:00:00Z"
  },
  {
    "TableName": "Orders",
    "TableStatus": "ACTIVE",
    "CreationDateTime": "2023-10-02T14:30:00Z"
  }
]

例2：特定のテーブルを説明する

ユーザーがクエリを送信します： "Users テーブルの構造を教えて" Claude は describe-table ツールを呼び出し、パラメータ {tableName: "Users"} を渡し、以下の結果を返します：

{
  "TableName": "Users",
  "TableStatus": "ACTIVE",
  "KeySchema": [
    { "AttributeName": "Username", "KeyType": "HASH" },
    { "AttributeName": "UserId", "KeyType": " RANGE" }
  ],
  "ProvisionedThroughput": {
    "ReadCapacityUnits": 10,
    "WriteCapacityUnits": 5
  }
}

例3：テーブルデータをスキャンする

ユーザーがクエリを送信します： "Users テーブル内のすべてのユーザーのユーザー名をリストして" Claude は scan-table ツールを呼び出し、フィルタ条件 { TableName: "Users", Filter: { Username: {"contains": "admin"} } } を渡し、以下の結果を返します：

[
  { "Username": "admin123" },
  { "Username": "superuser" },
  { "Username": "administrator" }
]

高度な使用法

データフローの概要

1. ユーザーが Claude に自然言語クエリを送信します。
2. Claude がリクエストを分析し、適切な MCP ツールを選択します。
3. 対応する DynamoDB 操作（query、scan など）を呼び出します。
4. 返された結果を処理し、ユーザーにやさしいレスポンスを生成します。
5. 結果を構造化または自然言語形式でユーザーに返します。

📄 ライセンス

このプロジェクトは MIT ライセンスを使用しています。詳細情報については LICENSE ファイルを参照してください。