remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Azure TableStore MCP サーバー

Cline を介して Azure Table Storage と直接やり取りできる TypeScript ベースの MCP サーバーです。このツールを使用すると、Azure Storage テーブル内のデータのクエリと管理が可能になります。

特徴

OData フィルターサポートを使用して Azure ストレージテーブルをクエリする
データ構造を理解するためにテーブルスキーマを取得する
ストレージアカウント内のすべてのテーブルを一覧表示する
詳細なエラー処理と応答情報
接続文字列によるシンプルな構成

インストール

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

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

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

依存関係をインストールします:

npm install

サーバーを構築します。

npm run build

NPMのインストール

npm 経由でパッケージをグローバルにインストールできます。

npm install -g dkmaker-mcp-server-tablestore

または、npx を使用して直接実行します。

npx dkmaker-mcp-server-tablestore

注: npx またはグローバルインストールを使用する場合でも、AZURE_STORAGE_CONNECTION_STRING 環境変数を構成する必要があります。

Clineへのインストール

Cline で Azure TableStore サーバーを使用するには、MCP 設定に Azure TableStore サーバーを追加する必要があります。設定ファイルは次の場所にあります。

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 ストレージアカウントの接続文字列

Clineでの使用

⚠️重要な安全上の注意：query_tableツールは、LLMのコンテキストウィンドウを保護するため、結果のサブセット（デフォルト：5件）を制限して返します。ユーザーが明示的に確認しない限り、この制限を増やさないでください。結果セットが大きくなると、コンテキストウィンドウが過負荷になる可能性があります。

インストールが完了すると、Cline 経由で Azure TableStore サーバーを使用できるようになります。以下に例をいくつか示します。

テーブルのクエリ:

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のコンテキストウィンドウの過負荷を防ぐためのものです。この制限は、ユーザーが明示的に確認した場合にのみ増やしてください。

テーブルスキーマの取得:

Show me the schema for the Orders table

Cline は get_table_schema ツールを次のように使用します。

{
  "tableName": "Orders"
}

テーブルの一覧:

List all tables in the storage account

Cline は、list_tables ツールを次のように使用します。

{}

プロジェクト構造

src/index.ts : Azure Table Storage の相互作用ロジックを備えたメインサーバーの実装
build/ : コンパイルされたJavaScript出力
package.json : プロジェクトの依存関係とスクリプト

依存関係

@azure/data-tables: Azure テーブルストレージクライアントライブラリ
@modelcontextprotocol/sdk: MCP サーバー実装ツールキット

ライセンス

このプロジェクトはMITライセンスに基づきます。詳細はLICENSEファイルをご覧ください。つまり、元の著作権表示とライセンス条項を記載すれば、コードを自由に使用、改変、配布、サブライセンスすることができます。

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

Cline を介して Azure Table Storage を直接操作できます。このツールを使用すると、Azure Storage テーブル内のデータのクエリと管理が可能になります。