Excel MCP Server

README em japonês

Excel MCP Server

Um servidor MCP multiplataforma para ler, escrever e formatar arquivos Excel. Funciona tanto com pastas de trabalho do Excel abertas (ao vivo) quanto com arquivos .xlsx fechados (sem precisar do Excel).

Dois Modos

• workbook — Opere em uma pasta de trabalho do Excel aberta em tempo real via xlwings
• path — Edite arquivos .xlsx fechados diretamente usando Python puro (preserva imagens, gráficos e todo o conteúdo incorporado)

Ferramentas

Ferramenta	pasta de trabalho	caminho	Obrigatório
get_excel_info	-	-	(nenhum)
read_cells	OK	OK	intervalo
write_cells	OK	OK	intervalo, valor
format_cells	OK	OK	intervalo, formato
execute_vba	OK	-	pasta de trabalho, código

Requisitos

• Node.js 18+
• Python 3.8+
• xlwings (para o modo Excel ao vivo — pip install xlwings)
• Microsoft Excel (necessário apenas para o modo workbook e execute_vba)

Funciona em Windows e macOS. O modo path também funciona no Linux.

Instalação

git clone https://github.com/kousunh/excel-mcp-server.git
cd excel-mcp-server
npm install
pip install -r scripts/requirements.txt

Configurar Cliente MCP

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

{
  "mcpServers": {
    "excel-mcp": {
      "command": "node",
      "args": ["/path/to/excel-mcp-server/src/index.js"]
    }
  }
}

Para usar um executável Python específico, defina a variável de ambiente EXCEL_MCP_PYTHON:

{
  "mcpServers": {
    "excel-mcp": {
      "command": "node",
      "args": ["/path/to/excel-mcp-server/src/index.js"],
      "env": {
        "EXCEL_MCP_PYTHON": "/path/to/python"
      }
    }
  }
}

Uso

Arquivos fechados (modo caminho)

read_cells   path="/data/report.xlsx" range="A1:D20" formats=true
write_cells  path="/data/report.xlsx" range="A1:C3" value=[["Name","Age","City"],["Alice",30,"NYC"],["Bob",25,"LA"]]
format_cells path="/data/report.xlsx" range="A1:C1" format={"bold":true,"backgroundColor":"#4472C4","fontColor":"#FFFFFF"}

Nenhuma instalação do Excel é necessária. Imagens, gráficos e formas são preservados.

Pastas de trabalho abertas (modo pasta de trabalho)

get_excel_info
read_cells   workbook="Sales.xlsx" range="B2:F10"
write_cells  workbook="Sales.xlsx" range="G2" value="=SUM(B2:F2)"
execute_vba  workbook="Sales.xlsx" code="Range(\"A1:G10\").AutoFilter"

Requer que o Excel esteja em execução com a pasta de trabalho aberta.

Licença

MIT