Excel MCP Server

Excel MCP Server

Uma implementação de servidor Model Context Protocol (MCP) que fornece capacidades de manipulação de arquivos Excel sem exigir a instalação do Microsoft Excel. Este servidor permite criação de pastas de trabalho, manipulação de dados, formatação e recursos avançados do Excel.

Requisitos

• Python 3.10+
• MCP SDK 1.2.0+
• OpenPyXL 3.1.2+

Componentes

Recursos

O servidor fornece manipulação de pastas de trabalho do Excel por meio do OpenPyXL:

• Cria e modifica pastas de trabalho do Excel
• Gerencia planilhas e intervalos
• Lida com formatação e estilos
• Suporta gráficos e tabelas dinâmicas

Ferramentas

Este servidor fornece um conjunto abrangente de ferramentas de manipulação do Excel. Para documentação detalhada de todas as ferramentas disponíveis, seus parâmetros e exemplos de uso, consulte TOOLS.md.

As ferramentas incluem capacidades para:

• Gerenciamento de pastas de trabalho e planilhas
• Leitura e escrita de dados
• Formatação e estilos
• Gráficos e visualizações
• Tabelas dinâmicas e análise de dados

Consulte TOOLS.md para documentação completa.

Recursos

• Suporte Completo ao Excel: Funcionalidade abrangente do Excel
• Manipulação de Dados: Ler, escrever e transformar dados
• Recursos Avançados: Gráficos, tabelas dinâmicas e formatação
• Tratamento de Erros: Tratamento abrangente de erros com mensagens claras

Uso

Configuração de Ambiente

O servidor pode ser configurado usando as seguintes variáveis de ambiente:

• EXCEL_FILES_PATH: Diretório onde os arquivos Excel serão armazenados (padrão: ./excel_files)

Você pode definir isso de diferentes maneiras:

Windows CMD:

set EXCEL_FILES_PATH=C:\path\to\excel\files
uv run excel-mcp-server

Windows PowerShell:

$env:EXCEL_FILES_PATH="C:\path\to\excel\files"
uv run excel-mcp-server

Linux/MacOS:

export EXCEL_FILES_PATH=/path/to/excel/files
uv run excel-mcp-server

Ou na configuração do Claude Desktop:

{
  "mcpServers": {
    "excel": {
      "command": "uv run excel-mcp-server",
      "transport": "sse",
      "env": {
        "EXCEL_FILES_PATH": "/path/to/excel/files"
      }
    }
  }
}

Iniciando o Servidor

Inicie o servidor:

uv run excel-mcp-server

O servidor iniciará no modo SSE e aguardará conexões de clientes MCP.

Conectando no Cursor IDE

Após iniciar o servidor, conecte-se ao endpoint SSE no Cursor IDE:

http://localhost:8000/sse

As ferramentas do Excel MCP estarão disponíveis através do agente.

Para ferramentas disponíveis e seu uso, consulte TOOLS.md.

Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.