MCP Azure Tablestorage

🚀 Azure 表存储 MCP サーバー

Azure 表存储 MCP サーバーは、TypeScript で構築された MCP サーバーで、Cline を通じて直接 Azure 表ストレージとやり取りできます。このツールを使用すると、Azure ストレージ テーブル内のデータをクエリし、管理することができます。

🚀 クイックスタート

このセクションでは、Azure 表ストレージ MCP サーバーの基本的な使い方を説明します。

✨ 主な機能

• OData フィルターを使用して Azure ストレージ テーブルをクエリすることができます。
• テーブルのスキーマを取得して、データ構造を把握することができます。
• ストレージ アカウント内のすべてのテーブルを一覧表示することができます。
• 詳細なエラー処理とレスポンス情報が提供されます。
• 簡単な接続文字列の設定が可能です。

📦 インストール

ローカル開発環境のセットアップ

1. リポジトリをクローンします。

git clone https://github.com/dkmaker/mcp-azure-tablestorage.git
cd mcp-azure-tablestorage

2. 依存関係をインストールします。

npm install

3. サーバーをビルドします。

npm run build

NPM を使用したインストール

npm を使用してグローバルにパッケージをインストールすることができます。

npm install -g dkmaker-mcp-server-tablestore

または、npx を使用して直接実行することもできます。

npx dkmaker-mcp-server-tablestore

⚠️ 重要な注意事項：npx またはグローバルインストールを使用する場合でも、AZURE_STORAGE_CONNECTION_STRING 環境変数の設定が必要です。

Cline でのインストール

Azure 表ストレージ サーバーを Cline で使用するには、MCP 設定構成ファイルに追加する必要があります。構成ファイルは以下の場所にあります。

Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

構成ファイルに以下の内容を追加します。

{
  "mcpServers": {
    "tablestore": {
      "command": "node",
      "args": ["C:/path/to/your/mcp-azure-tablestorage/build/index.js"],
      "env": {
        "AZURE_STORAGE_CONNECTION_STRING": "your_connection_string_here"  // 必須：Azure ストレージの接続文字列
      }
    }
  }
}

C:/path/to/your/mcp-azure-tablestorage を実際にクローンしたリポジトリのパスに置き換えてください。

🔧 設定

このサーバーでは、以下の環境変数が必要です。

• AZURE_STORAGE_CONNECTION_STRING：Azure ストレージ アカウントの接続文字列

💻 使用例

基本的な使用法

⚠️ 重要なセキュリティ注意事項：query_table ツールはデフォルトで結果セットの最初の 1,000 行を返します。完全な結果を取得するには、クエリに $top=10000 パラメーターを含めてください。

# Users テーブルをクエリし、PartitionKey が 'ACTIVE' のレコードを取得します。
clitable tablestore query "Users" --where "PartitionKey='ACTIVE'"

# Items テーブルに新しいレコードを挿入します。
clitable tablestore insert "Items" --json '{"id": 1, "name": "Item 1"}'

# Items テーブル内の既存のレコードを更新します。
clitable tablestore update "Items" --where "PartitionKey=1" --set "Name='NewItem'"

# Users テーブル内の PartitionKey が 'ARCHIVED' のレコードを削除します。
clitable tablestore delete "Users" --where "PartitionKey='ARCHIVED'"

出力形式

すべてのコマンドの結果は、読みやすく分析しやすい表形式で表示されます。

📚 ドキュメント

プロジェクト構造

src/
├── index.ts              # メインエントリーファイル
├── commands/             # 各操作の定義が含まれています。
│   ├── query.ts         # テーブルデータのクエリ
│   ├── insert.ts        # 新しいレコードの挿入
│   ├── update.ts        # 既存のレコードの更新
│   └── delete.ts        # レコードの削除
└── config.json          # 接続文字列などの設定ファイル

依存関係

{
  "name": "mcp-azure-tablestorage",
  "version": "1.0.0",
  "dependencies": {
    "@types/azure-storage": "^latest",
    "cli-table": "^latest"
  }
}

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。これにより、派生作品に元の著作権表示とライセンス条項を含める限り、コードを自由に使用、変更、配布することができます。