MCP Azure Tablestorage

🚀 Azure 表存儲 MCP 服務器

Azure 表存儲 MCP 服務器是一個基於 TypeScript 的工具，它支持直接通過 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 中安裝

要在 Cline 中使用 Azure 表存儲服務器，請將其添加到 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 許可證，允許您自由使用、修改和分發代碼，只要在衍生作品中包含原始版權聲明和許可條款。