Azure TableStore

Servidor MCP Azure TableStore

Um servidor MCP baseado em TypeScript que permite interação com o Azure Table Storage diretamente pelo Cline. Esta ferramenta permite consultar e gerenciar dados em Tabelas do Azure Storage.

Recursos

• Consultar Tabelas do Azure Storage com suporte a filtros OData
• Obter esquemas de tabelas para entender a estrutura dos dados
• Listar todas as tabelas na conta de armazenamento
• Tratamento detalhado de erros e informações de resposta
• Configuração simples por meio de string de conexão

Instalação

Configuração de Desenvolvimento Local

1. Clone o repositório:

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

2. Instale as dependências:

npm install

3. Compile o servidor:

npm run build

Instalação via NPM

Você pode instalar o pacote globalmente via npm:

npm install -g dkmaker-mcp-server-tablestore

Ou executá-lo diretamente com npx:

npx dkmaker-mcp-server-tablestore

Observação: Ao usar npx ou instalação global, você ainda precisará configurar a variável de ambiente AZURE_STORAGE_CONNECTION_STRING.

Instalando no Cline

Para usar o servidor Azure TableStore com o Cline, você precisa adicioná-lo à configuração de MCP. O arquivo de configuração está localizado em:

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

Adicione o seguinte à sua configuração:

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

Substitua C:/path/to/your/mcp-azure-tablestorage pelo caminho real onde você clonou o repositório.

Configuração

O servidor requer a seguinte variável de ambiente:

• AZURE_STORAGE_CONNECTION_STRING: Sua string de conexão da conta do Azure Storage

Uso no Cline

⚠️ AVISO IMPORTANTE DE SEGURANÇA: A ferramenta query_table retorna um subconjunto limitado de resultados (padrão: 5 itens) para proteger a janela de contexto do LLM. NÃO aumente esse limite a menos que seja explicitamente confirmado pelo usuário, pois conjuntos de resultados maiores podem sobrecarregar a janela de contexto.

Após a instalação, você pode usar o servidor Azure TableStore pelo Cline. Aqui estão alguns exemplos:

1. Consultando uma tabela:

Query the Users table where PartitionKey is 'ACTIVE'

O Cline usará a ferramenta query_table com:

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

A resposta incluirá:

• Número total de itens que correspondem à consulta (sem limite)
• Subconjunto limitado de itens (padrão 5) para processamento seguro pelo LLM
• Valor do limite aplicado

Por exemplo:

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

Este design permite que o LLM entenda o escopo completo dos dados enquanto trabalha com um subconjunto gerenciável. O limite padrão de 5 itens protege contra a sobrecarga da janela de contexto do LLM — este limite só deve ser aumentado quando explicitamente confirmado pelo usuário.

2. Obtendo o esquema da tabela:

Show me the schema for the Orders table

O Cline usará a ferramenta get_table_schema com:

{
  "tableName": "Orders"
}

3. Listando tabelas:

List all tables in the storage account

O Cline usará a ferramenta list_tables com:

{}

Estrutura do Projeto

• src/index.ts: Implementação principal do servidor com lógica de interação com o Azure Table Storage
• build/: Saída JavaScript compilada
• package.json: Dependências e scripts do projeto

Dependências

• @azure/data-tables: Biblioteca cliente do Azure Table Storage
• @modelcontextprotocol/sdk: Kit de ferramentas de implementação do servidor MCP

Licença

Este projeto é licenciado sob a Licença MIT — consulte o arquivo LICENSE para obter detalhes. Isso significa que você pode usar, modificar, distribuir e sublicenciar o código livremente, desde que inclua o aviso de direitos autorais original e os termos da licença.