Azure TableStore MCP Server

Azure TableStore MCP サーバー

Cline を通じて Azure Table Storage を直接操作できる、TypeScript ベースの MCP サーバーです。このツールを使うと、Azure Storage Tables のデータをクエリして管理できます。

機能

• OData フィルターに対応した Azure Storage Tables のクエリ
• データ構造を把握するためのテーブルスキーマの取得
• ストレージアカウント内のすべてのテーブルの一覧表示
• 詳細なエラー処理と応答情報
• 接続文字列による簡単な設定

インストール

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

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 TableStore サーバーを 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"  // Required: Your Azure Storage connection string
      }
    }
  }
}

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

設定

サーバーには次の環境変数が必要です：

• AZURE_STORAGE_CONNECTION_STRING：Azure Storage アカウントの接続文字列

Cline での使用方法

⚠️ 重要な安全上の注意：query_table ツールは、LLM のコンテキストウィンドウを保護するため、結果の一部のみを返します（デフォルト：5 件）。ユーザーが明示的に確認した場合を除き、この上限を増やさないでください。結果が多いと、コンテキストウィンドウが圧迫される可能性があります。

インストール後、Cline を通じて Azure TableStore サーバーを使用できます。以下に例を示します：

1. テーブルにクエリを実行する：

Query the Users table where PartitionKey is 'ACTIVE'

Cline は次の内容で query_table ツールを使用します：

{
  "tableName": "Users",
  "filter": "PartitionKey eq 'ACTIVE'",
  "limit": 5  // Optional: Defaults to 5 items. WARNING: Do not increase without user confirmation
}

応答には次の内容が含まれます：

• クエリに一致する項目の総数（上限なし）
• 安全に LLM で処理できる、項目の一部（デフォルトは 5 件）
• 適用された上限値

例：

{
  "totalItems": 25,
  "limit": 5,
  "items": [
    // First 5 matching items
  ]
}

この設計により、LLM は扱いやすい件数のデータを処理しながら、データ全体の規模を把握できます。デフォルトの上限である 5 件は、LLM のコンテキストウィンドウが圧迫されるのを防ぎます。この上限は、ユーザーが明示的に確認した場合にのみ増やしてください。

2. テーブルスキーマを取得する：

Show me the schema for the Orders table

Cline は次の内容で get_table_schema ツールを使用します：

{
  "tableName": "Orders"
}

3. テーブルの一覧を表示する：

List all tables in the storage account

Cline は次の内容で list_tables ツールを使用します：

{}

プロジェクト構成

• src/index.ts：Azure Table Storage との連携ロジックを含む、サーバーのメイン実装
• build/：コンパイル済み JavaScript の出力先
• package.json：プロジェクトの依存関係とスクリプト

依存関係

• @azure/data-tables：Azure Table Storage クライアントライブラリ
• @modelcontextprotocol/sdk：MCP サーバー実装ツールキット

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については LICENSE ファイルを参照してください。著作権表示とライセンス条項を原文のまま含めれば、コードを自由に使用、変更、配布、サブライセンスできます。