Azure TableStore

Un servidor MCP para interactuar con Azure Table Storage, que requiere una cadena de conexión de Azure Storage.

Documentación

Azure TableStore MCP Server

Un servidor MCP basado en TypeScript que permite la interacción con Azure Table Storage directamente a través de Cline. Esta herramienta te permite consultar y gestionar datos en Azure Storage Tables.

Características

Consultar Azure Storage Tables con soporte de filtro OData
Obtener esquemas de tablas para entender la estructura de datos
Listar todas las tablas en la cuenta de almacenamiento
Manejo detallado de errores e información de respuesta
Configuración sencilla mediante cadena de conexión

Instalación

Configuración de desarrollo local

Clona el repositorio:

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

Instala las dependencias:

npm install

Compila el servidor:

npm run build

Instalación mediante NPM

Puedes instalar el paquete globalmente mediante npm:

npm install -g dkmaker-mcp-server-tablestore

O ejecutarlo directamente con npx:

npx dkmaker-mcp-server-tablestore

Nota: Al usar npx o la instalación global, aún necesitarás configurar la variable de entorno AZURE_STORAGE_CONNECTION_STRING.

Instalación en Cline

Para usar el servidor Azure TableStore con Cline, debes agregarlo a la configuración de ajustes de MCP. El archivo de configuración se encuentra en:

Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

Agrega lo siguiente a tu configuración:

{
  "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
      }
    }
  }
}

Reemplaza C:/path/to/your/mcp-azure-tablestorage con la ruta real donde clonaste el repositorio.

Configuración

El servidor requiere la siguiente variable de entorno:

AZURE_STORAGE_CONNECTION_STRING: La cadena de conexión de tu cuenta de Azure Storage

Uso en Cline

⚠️ NOTA DE SEGURIDAD IMPORTANTE: La herramienta query_table devuelve un subconjunto limitado de resultados (por defecto: 5 elementos) para proteger la ventana de contexto del LLM. NO aumentes este límite a menos que el usuario lo confirme explícitamente, ya que conjuntos de resultados más grandes pueden abrumar la ventana de contexto.

Una vez instalado, puedes usar el servidor Azure TableStore a través de Cline. Aquí hay algunos ejemplos:

Consultar una tabla:

Query the Users table where PartitionKey is 'ACTIVE'

Cline usará la herramienta query_table con:

{
  "tableName": "Users",
  "filter": "PartitionKey eq 'ACTIVE'",
  "limit": 5  // Optional: Defaults to 5 items. WARNING: Do not increase without user confirmation
}

La respuesta incluirá:

Número total de elementos que coinciden con la consulta (sin límite)
Subconjunto limitado de elementos (por defecto 5) para un procesamiento seguro del LLM
Valor de límite aplicado

Por ejemplo:

{
  "totalItems": 25,
  "limit": 5,
  "items": [
    // First 5 matching items
  ]
}

Este diseño permite que el LLM comprenda el alcance completo de los datos mientras trabaja con un subconjunto manejable. El límite predeterminado de 5 elementos protege contra la saturación de la ventana de contexto del LLM: este límite solo debe aumentarse cuando el usuario lo confirme explícitamente.

Obtener el esquema de la tabla:

Show me the schema for the Orders table

Cline usará la herramienta get_table_schema con:

{
  "tableName": "Orders"
}

Listar tablas:

List all tables in the storage account

Cline usará la herramienta list_tables con:

{}

Estructura del Proyecto

src/index.ts: Implementación principal del servidor con lógica de interacción con Azure Table Storage
build/: Salida de JavaScript compilado
package.json: Dependencias y scripts del proyecto

Dependencias

@azure/data-tables: Biblioteca cliente de Azure Table Storage
@modelcontextprotocol/sdk: Kit de herramientas de implementación del servidor MCP

Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles. Esto significa que puedes usar, modificar, distribuir y sublicenciar el código libremente, siempre que incluyas el aviso de copyright original y los términos de la licencia.