remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Servidor MCP de Azure TableStore

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

Características

Consultar tablas de Azure Storage con compatibilidad con filtros OData
Obtenga esquemas de tablas para comprender la estructura de datos
Enumere todas las tablas en la cuenta de almacenamiento
Información detallada sobre el manejo de errores y respuestas
Configuración sencilla a través de cadena de conexión

Instalación

Configuración de desarrollo local

Clonar el repositorio:

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

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Instalación de NPM

Puede instalar el paquete globalmente a través de npm:

npm install -g dkmaker-mcp-server-tablestore

O ejecútelo directamente con npx:

npx dkmaker-mcp-server-tablestore

Nota: Al utilizar npx o una instalación global, aún deberá configurar la variable de entorno AZURE_STORAGE_CONNECTION_STRING.

Instalación en Cline

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

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

Añade 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
      }
    }
  }
}

Reemplace C:/path/to/your/mcp-azure-tablestorage con la ruta real donde clonó el repositorio.

Configuración

El servidor requiere la siguiente variable de entorno:

AZURE_STORAGE_CONNECTION_STRING : cadena de conexión de su cuenta de Azure Storage

Uso en Cline

⚠️ NOTA IMPORTANTE DE SEGURIDAD : La herramienta query_table devuelve un subconjunto limitado de resultados (predeterminado: 5 elementos) para proteger la ventana de contexto del LLM. NO aumente este límite a menos que el usuario lo confirme explícitamente, ya que conjuntos de resultados mayores pueden saturar la ventana de contexto.

Una vez instalado, puede usar el servidor Azure TableStore a través de Cline. A continuación, se muestran algunos ejemplos:

Consultar una tabla:

Query the Users table where PartitionKey is 'ACTIVE'

Cline utilizará 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 (predeterminado 5) para un procesamiento LLM seguro
Valor límite aplicado

Por ejemplo:

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

Este diseño permite al LLM comprender el alcance completo de los datos mientras trabaja con un subconjunto manejable. El límite predeterminado de 5 elementos evita que se sature la ventana de contexto del LLM; este límite solo debe aumentarse con la confirmación explícita del usuario.

Obtener el esquema de la tabla:

Show me the schema for the Orders table

Cline utilizará la herramienta get_table_schema con:

{
  "tableName": "Orders"
}

Tablas de listado:

List all tables in the storage account

Cline utilizará la herramienta list_tables con:

{}

Estructura del proyecto

src/index.ts : Implementación del servidor principal con lógica de interacción de Azure Table Storage
build/ : Salida de JavaScript compilada
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 (consulte el archivo de LICENCIA para obtener más información). Esto significa que puede usar, modificar, distribuir y sublicenciar el código libremente, siempre que incluya el aviso de derechos de autor y los términos de la licencia originales.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

Permite interactuar con Azure Table Storage directamente a través de Cline. Esta herramienta permite consultar y administrar datos en tablas de Azure Storage.