MCP Azure Tablestorage

一个基于TypeScript的MCP服务器，支持通过Cline直接与Azure表存储交互，提供查询、管理和分析数据的功能。

云存储开发者工具 #Azure存储 #数据查询 #表管理 #MCP服务本地 .TypeScript

评分 : 2.5分

下载量 : 27

更新时间 : 2025-04-29

什么是Azure TableStore MCP服务器？

Azure TableStore MCP服务器是一款基于TypeScript开发的工具，它允许用户通过Cline直接与Azure Table Storage进行交互。您可以轻松查询、管理和分析存储在Azure中的表格数据。

如何使用Azure TableStore MCP服务器？

您可以通过配置环境变量并运行相应的命令来查询和管理您的Azure Table Storage数据。支持OData过滤器语法，方便高效地筛选所需的数据。

适用场景

适用于需要频繁操作Azure Table Storage的企业和个人开发者，尤其是希望简化数据管理流程的团队。

主要功能

高级查询支持使用OData过滤器语法快速定位目标数据。

表结构查看获取表的具体结构，便于理解数据格式。

表格列表展示列出当前Azure存储账户下的所有表格。

错误处理内置详细的错误提示机制，确保问题定位准确。

优势与局限性

优势

强大的OData查询能力，提升数据检索效率。

易于集成至现有的工作流中。

详尽的日志记录和错误报告机制。

开源且免费使用，社区支持活跃。

局限性

对大规模数据集可能影响性能。

需要预先配置Azure存储连接字符串。

部分高级特性依赖于Azure SDK的支持。

如何使用

安装服务器

首先克隆项目代码并安装依赖项。

配置环境变量

设置AZURE_STORAGE_CONNECTION_STRING以连接到您的Azure存储账户。

启动服务器

执行构建后的脚本以启动服务。

使用案例

查询特定条件的数据查询名为'Users'的表，筛选出PartitionKey为'ACTIVE'的记录。

获取表结构查看'Orders'表的详细结构。

列出所有表格列出当前Azure存储账户中的所有表格。

常见问题

如何配置AZURE_STORAGE_CONNECTION_STRING？

为什么查询结果会限制数量？

是否可以自定义查询限制？

🚀 Azure 表存储 MCP 服务器

Azure 表存储 MCP 服务器是一个基于 TypeScript 的工具，它支持直接通过 Cline 与 Azure 表存储交互，能够让您轻松查询和管理 Azure 存储表中的数据。

🚀 快速开始

要使用 Azure 表存储 MCP 服务器，您可以按照以下步骤进行安装和配置。

✨ 主要特性

使用 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 表存储服务器，请将其添加到 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"
  }
}