mcp-azure-tablestorage

Azure TableStore MCP サーバー

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

特徴

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

インストール

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

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

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

3. サーバーを構築します。

NPMのインストール

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

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

注: 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

設定に以下を追加します。

C:/path/to/your/mcp-azure-tablestorageリポジトリのクローンを作成した実際のパスに置き換えます。

構成

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

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

Clineでの使用

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

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

1. テーブルのクエリ:

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

回答には次の内容が含まれます:

• クエリに一致するアイテムの合計数（制限なし）
• 安全な LLM 処理のための限定された項目のサブセット (デフォルトは 5)
• 適用限界値

例えば：

この設計により、LLMは管理可能なサブセットを扱いながら、データの全範囲を把握できます。デフォルトの5項目の制限は、LLMのコンテキストウィンドウの過負荷を防ぐためのものです。この制限は、ユーザーが明示的に確認した場合にのみ増やしてください。

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

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

3. テーブルの一覧:

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

プロジェクト構造

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

依存関係

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

ライセンス

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