Servidor MCP Excel | Awesome MCP Servers

Um servidor Model Context Protocol (MCP) que permite manipular arquivos Excel sem precisar ter o Microsoft Excel instalado. Crie, leia e modifique pastas de trabalho do Excel com seu agente de IA.

Recursos

📊 Operações do Excel: Crie, leia e atualize pastas de trabalho e planilhas
📈 Manipulação de Dados: Fórmulas, formatação, gráficos, tabelas dinâmicas e tabelas do Excel
🔍 Validação de Dados: Validação integrada para intervalos, fórmulas e integridade dos dados
🎨 Formatação: Estilo de fontes, cores, bordas, alinhamento e formatação condicional
📋 Operações de Tabela: Crie e gerencie tabelas do Excel com estilo personalizado
📊 Criação de Gráficos: Gere vários tipos de gráficos (linha, barra, pizza, dispersão, etc.)
🔄 Tabelas Dinâmicas: Crie tabelas dinâmicas para análise de dados
🔧 Gerenciamento de Planilhas: Copie, renomeie e exclua planilhas com facilidade
🔌 Suporte a três transportes: stdio, SSE (obsoleto) e HTTP transmissível
🌐 Remoto e Local: Funciona tanto localmente quanto como serviço remoto

Uso

O servidor suporta três métodos de transporte:

1. Transporte Stdio (para uso local)

uvx excel-mcp-server stdio

{
   "mcpServers": {
      "excel": {
         "command": "uvx",
         "args": ["excel-mcp-server", "stdio"]
      }
   }
}

2. Transporte SSE (Server-Sent Events - Obsoleto)

uvx excel-mcp-server sse

Conexão de transporte SSE:

{
   "mcpServers": {
      "excel": {
         "url": "http://localhost:8000/sse",
      }
   }
}

3. Transporte HTTP Transmissível (Recomendado para conexões remotas)

uvx excel-mcp-server streamable-http

Conexão de transporte HTTP transmissível:

{
   "mcpServers": {
      "excel": {
         "url": "http://localhost:8000/mcp",
      }
   }
}

Variáveis de Ambiente e Tratamento de Caminhos de Arquivo

Transportes SSE e HTTP Transmissível

Ao executar o servidor com os protocolos SSE ou HTTP transmissível, você deve definir a variável de ambiente EXCEL_FILES_PATH no lado do servidor. Essa variável informa ao servidor onde ler e gravar arquivos Excel.

Se não for definida, o padrão é ./excel_files.
Com esses transportes, os valores da ferramenta filepath devem ser relativos a esse diretório (por exemplo, reports/q1.xlsx); caminhos absolutos e travessia de diretórios são rejeitados.

Você também pode definir a variável de ambiente FASTMCP_PORT para controlar a porta em que o servidor escuta (o padrão é 8017 se não for definida).

Exemplo (Windows PowerShell):

$env:EXCEL_FILES_PATH="E:\MyExcelFiles"
$env:FASTMCP_PORT="8007"
uvx excel-mcp-server streamable-http

Exemplo (Linux/macOS):

EXCEL_FILES_PATH=/path/to/excel_files FASTMCP_PORT=8007 uvx excel-mcp-server streamable-http

Transporte Stdio

Ao usar o protocolo stdio, o caminho do arquivo é fornecido em cada chamada de ferramenta, portanto você não precisa definir EXCEL_FILES_PATH no servidor. O servidor usará o caminho enviado pelo cliente para cada operação.

Ferramentas Disponíveis

O servidor fornece um conjunto abrangente de ferramentas de manipulação do Excel. Consulte TOOLS.md para documentação completa de todas as ferramentas disponíveis.

Histórico de Estrelas

Licença

Licença MIT - consulte LICENSE para obter detalhes.

Excel

Documentação