Azure TableStore MCP 服务器

一个基于 TypeScript 的 MCP 服务器，允许通过 Cline 直接与 Azure 表存储进行交互。此工具允许您查询和管理 Azure 存储表中的数据。

<a href="https://glama.ai/mcp/servers/8kah8zukke"><img width="380" height="200" src="https://glama.ai/mcp/servers/8kah8zukke/badge?refresh=1" alt="mcp-azure-tablestorage MCP server" /></a>

功能

• 使用 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 中安装

要将 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"  // 必需：您的 Azure 存储连接字符串
      }
    }
  }
}

将 C:/path/to/your/mcp-azure-tablestorage 替换为您克隆存储库的实际路径。

配置

服务器需要以下环境变量：

• AZURE_STORAGE_CONNECTION_STRING: 您的 Azure 存储帐户连接字符串

在 Cline 中使用

⚠️ 重要安全提示: query_table 工具返回有限的结果子集（默认：5 个项目），以保护 LLM 的上下文窗口。除非用户明确确认，否则请勿增加此限制，因为较大的结果集可能会使上下文窗口不堪重负。

安装完成后，您可以通过 Cline 使用 Azure TableStore 服务器。以下是一些示例：

1. 查询表：

Query the Users table where PartitionKey is 'ACTIVE'

Cline 将使用 query_table 工具，并带有：

{
  "tableName": "Users",
  "filter": "PartitionKey eq 'ACTIVE'",
  "limit": 5  // 可选：默认为 5 个项目。警告：未经用户确认，请勿增加
}

响应将包括：

• 与查询匹配的项目总数（无限制）
• 有限的项目子集（默认 5 个），用于安全的 LLM 处理
• 应用的限制值

例如：

{
  "totalItems": 25,
  "limit": 5,
  "items": [
    // 前 5 个匹配的项目
  ]
}

这种设计允许 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 表存储交互逻辑的主服务器实现
• build/: 编译后的 JavaScript 输出
• package.json: 项目依赖项和脚本

依赖项

• @azure/data-tables: Azure 表存储客户端库
• @modelcontextprotocol/sdk: MCP 服务器实现工具包

许可证

该项目已获得 MIT 许可证的许可 - 有关详细信息，请参见 LICENSE 文件。 这意味着您可以自由地使用、修改、分发和再许可代码，前提是您包含原始版权声明和许可条款。