Excel MCP Server

Manipule arquivos Excel (XLSX, XLSM, etc.) sem precisar do Microsoft Excel, com um assistente de IA integrado.

GitHub
34
Experimente este MCPPatrocinado

Documentação

Excel MCP Server - Model Context Protocol para Excel sem Microsoft Excel

MCP Compatible npm version AI Powered Verified on MseeP Python 3.8+ Downloads GitHub Stars License: MIT

Um servidor Model Context Protocol (MCP) que permite manipular arquivos Excel sem precisar do Microsoft Excel instalado. Crie, leia, escreva e analise pastas de trabalho do Excel (.xlsx, .xlsm) com assistentes de IA como o Claude. Automação completa do Excel por meio da integração com LLM.

Principais Recursos:

  • ✅ Leia e escreva arquivos Excel sem Microsoft Excel
  • ✅ Suporte completo para formatos XLSX, XLSM, XLTX, XLTM
  • ✅ Crie gráficos, tabelas dinâmicas e painéis
  • ✅ Importe/exporte CSV, JSON, SQL, PDF
  • ✅ Funciona com Claude AI e outros assistentes de LLM
  • ✅ Multiplataforma: Windows, macOS, Linux
  • ✅ Instalação fácil via npm/npx

Excel MCP Master

🌟 Recursos - Excel MCP Server

Manipulação Completa do Excel sem Microsoft Excel

  • 📊 Operações com arquivos Excel: Leia e escreva arquivos XLSX, XLSM, XLTX, XLTM
  • 📖 Extração de dados: Leia dados de planilhas Excel com suporte a paginação
  • ✍️ Operações de escrita: Escreva dados e fórmulas em pastas de trabalho do Excel
  • 📋 Gerenciamento de planilhas: Crie, exclua, renomeie e copie planilhas
  • 📈 Gráficos e visualizações: Crie gráficos, tabelas dinâmicas e painéis
  • 🔄 Importação/exportação de dados: Importe de CSV, JSON, SQL e exporte para vários formatos
  • 🎨 Formatação profissional: Estilo e formatação automáticos para documentos Excel

Principais Capacidades

📊 Operações de Dados

  • Leia e escreva arquivos Excel com suporte completo a formatação
  • Crie tabelas profissionais com estilo automático
  • Gere gráficos e visualizações
  • Importe de fontes CSV, JSON e SQL
  • Exporte para vários formatos (CSV, JSON, PDF)

🎨 Formatação Profissional

  • Ajuste automático da largura das colunas
  • Formatação e estilo de texto rico
  • Esquemas de cores e temas profissionais
  • Geração de documentos prontos para publicação

🏗️ Recursos Avançados

  • Painéis dinâmicos com múltiplas visualizações
  • Geração de relatórios baseada em modelos
  • Filtragem e análise de dados
  • Tabelas dinâmicas e cálculos avançados
  • Processamento em lote e automação

🔐 Segurança e Confiança

MseeP.ai Security Assessment Badge

Pontuação de Segurança: 100/100 | Nível de Risco: Baixo

Este projeto foi auditado de forma independente pela MseeP.ai, fornecendo validação de segurança contínua e avaliação de confiança para o ecossistema MCP.

🚀 Início Rápido - Instalação do Excel MCP Server

Instalação

A maneira mais fácil de usar o Excel MCP Server é com npx (sem necessidade de instalação):

npx @guillehr2/excel-mcp-server@latest

Ou instale globalmente:

npm install -g @guillehr2/excel-mcp-server

Configuração

Adicione à configuração do seu cliente MCP (ex.: Claude Desktop):

Usando npx (Recomendado)

{
  "mcpServers": {
    "excel-master": {
      "command": "npx",
      "args": [
        "-y",
        "@guillehr2/excel-mcp-server@latest"
      ]
    }
  }
}

Usando versão específica

{
  "mcpServers": {
    "excel-master": {
      "command": "npx",
      "args": [
        "-y",
        "@guillehr2/excel-mcp-server@1.0.7"
      ]
    }
  }
}

Usando instalação global

{
  "mcpServers": {
    "excel-master": {
      "command": "excel-mcp-server"
    }
  }
}

Modo de desenvolvimento

Se você está desenvolvendo ou deseja executar a partir do código-fonte:

{
  "mcpServers": {
    "excel-master": {
      "command": "node",
      "args": ["path/to/Excel-MCP-Server-Master/index.js"]
    }
  }
}

🛠️ Ferramentas do Excel MCP Server - Automação Completa do Excel

Operações com Arquivos Excel sem Microsoft Excel

  • Crie pastas de trabalho do Excel - create_workbook_tool
  • Abra arquivos Excel - open_workbook_tool (XLSX, XLSM, XLTX, XLTM)
  • Salve arquivos Excel - save_workbook_tool
  • Liste planilhas Excel - list_sheets_tool
  • Gerencie planilhas - add_sheet_tool, delete_sheet_tool, rename_sheet_tool

Manipulação de Dados do Excel

  • Escreva no Excel - write_sheet_data_tool, update_cell_tool
  • Leia do Excel - Extração de dados integrada com paginação
  • Tabelas Excel - add_table_tool, create_formatted_table_tool
  • Fórmulas Excel - Suporte completo a fórmulas em todas as operações de escrita

Gráficos e Análise do Excel

  • Crie gráficos Excel - add_chart_tool (coluna, barra, linha, pizza, dispersão)
  • Painéis Excel - create_dashboard_tool
  • Tabelas dinâmicas - Análise avançada de dados
  • Filtragem de dados - filter_data_tool

Importar/Exportar Dados do Excel

  • Importe para o Excel - import_data_tool (CSV, JSON, SQL)
  • Exporte do Excel - export_data_tool (CSV, JSON, PDF)
  • Exportação em PDF - export_single_sheet_pdf_tool, export_sheets_pdf_tool

💡 Exemplos de Uso

Criando um Relatório Profissional

# Create a new workbook with formatted data
result = create_formatted_table_tool(
    file_path="sales_report.xlsx",
    sheet_name="Q4 Sales",
    start_cell="A1",
    data=[
        ["Region", "Q4 Sales", "Growth %"],
        ["North", 125000, 15.2],
        ["South", 98000, 8.7],
        ["East", 156000, 22.1],
        ["West", 89000, -3.2]
    ],
    table_name="Q4SalesData",
    table_style="TableStyleMedium9",
    formats={
        "B2:B5": "#,##0",  # Number format for sales
        "C2:C5": "0.0%",   # Percentage format
        "A1:C1": {"bold": True, "fill_color": "366092"}  # Header styling
    }
)

# Add a chart based on the table data
chart_result = add_chart_tool(
    file_path="sales_report.xlsx",
    sheet_name="Q4 Sales",
    chart_type="column",
    data_range="A1:B5",
    title="Q4 Sales by Region",
    position="E2",
    style="colorful-1"
)

Construindo um Painel Dinâmico

# Create a comprehensive dashboard
dashboard_result = create_dashboard_tool(
    file_path="executive_dashboard.xlsx",
    data={
        "Data": [
            ["Month", "Revenue", "Expenses", "Profit"],
            ["Jan", 50000, 30000, 20000],
            ["Feb", 55000, 32000, 23000],
            ["Mar", 48000, 29000, 19000]
        ]
    },
    dashboard_config={
        "tables": [
            {
                "sheet": "Dashboard",
                "name": "MonthlyData",
                "range": "Data!A1:D4",
                "style": "TableStyleMedium9"
            }
        ],
        "charts": [
            {
                "sheet": "Dashboard",
                "type": "line",
                "data_range": "Data!A1:B4",
                "title": "Revenue Trend",
                "position": "E1",
                "style": "dark-blue"
            },
            {
                "sheet": "Dashboard",
                "type": "column",
                "data_range": "Data!A1:D4",
                "title": "Monthly Comparison",
                "position": "E15",
                "style": "colorful-2"
            }
        ]
    }
)

Importação e Análise de Dados

# Import data from multiple sources
import_result = import_data_tool(
    excel_file="analysis.xlsx",
    import_config={
        "csv": [
            {
                "file_path": "sales_data.csv",
                "sheet_name": "Sales",
                "delimiter": ",",
                "encoding": "utf-8"
            }
        ],
        "json": [
            {
                "file_path": "customer_data.json",
                "sheet_name": "Customers",
                "format": "records"
            }
        ]
    },
    create_tables=True
)

# Filter and analyze the imported data
filtered_data = filter_data_tool(
    file_path="analysis.xlsx",
    sheet_name="Sales",
    table_name="Table_Sales_1",
    filters={
        "Region": ["North", "South"],
        "Sales": {"gt": 10000}
    }
)

🎨 Recursos Profissionais

Formatação Automática

O servidor aplica automaticamente formatação profissional:

  • Ajuste da largura das colunas com base no comprimento do conteúdo
  • Otimização da altura das linhas para texto quebrado
  • Esquemas de cores profissionais para gráficos e tabelas
  • Estilo consistente em todos os documentos

Estilo de Gráficos

Amplas opções de personalização de gráficos:

  • Mais de 50 estilos predefinidos (temas claros, escuros, coloridos)
  • Paletas de cores personalizadas para consistência da marca
  • Layouts profissionais com espaçamento adequado
  • Vários tipos de gráficos: coluna, barra, linha, pizza, dispersão, área

Sistema de Modelos

Crie relatórios a partir de modelos:

  • Modelos reutilizáveis para relatórios consistentes
  • Substituição dinâmica de dados
  • Atualizações automáticas de gráficos
  • Preservação de formatação

📋 Requisitos

  • Node.js 14.0 ou superior
  • Python 3.8 ou superior
  • Sistema Operacional: Windows, macOS ou Linux

As dependências do Python são instaladas automaticamente na primeira execução:

  • fastmcp
  • openpyxl
  • pandas
  • numpy
  • matplotlib
  • xlsxwriter
  • xlrd
  • xlwt

📚 Documentação

Para documentação detalhada, consulte:

🤝 Contribuindo

Aceitamos contribuições! Consulte CONTRIBUTING.md para obter as diretrizes.

Configuração de Desenvolvimento

# Clone the repository
git clone https://github.com/guillehr2/Excel-MCP-Server-Master.git
cd Excel-MCP-Server-Master

# Install dependencies
npm install
pip install -r requirements.txt

# Run in development mode
node index.js

🐛 Solução de Problemas

Problemas Comuns

  1. Python não encontrado: Certifique-se de que o Python 3.8+ esteja instalado e no seu PATH
  2. Falha na instalação das dependências: Tente executar com privilégios de administrador
  3. O cliente MCP não reconhece o servidor: Reinicie o cliente MCP após a configuração

Para obter mais ajuda, consulte nosso guia de solução de problemas ou abra uma issue.

📄 Licença

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

🙏 Agradecimentos

  • Construído com FastMCP
  • Manipulação do Excel com tecnologia openpyxl
  • Processamento de dados com pandas
  • Publicado no npm para fácil distribuição
  • Agradecimento especial a lwsinclair pela auditoria de segurança independente e integração com a MseeP.ai

📊 Estatísticas

GitHub last commit GitHub issues GitHub pull requests npm bundle size

Feito com ❤️ para o ecossistema MCP

Se você achar este Excel MCP Server útil, considere dar uma ⭐ no GitHub!

Excel MCP Server por Guillem Hermida | GitHub | NPM | Contato: qtmsuite@gmail.com

Manipulação de Excel sem Microsoft Excel - servidor Model Context Protocol para integração com Claude AI e LLM