Excel MCP Server

日本語 README

Excel MCP Server

Un servidor MCP multiplataforma para leer, escribir y formatear archivos de Excel. Funciona tanto con libros de Excel abiertos (en vivo) como con archivos .xlsx cerrados (sin necesidad de Excel).

Dos Modos

• workbook — Operar sobre un libro de Excel abierto en tiempo real mediante xlwings
• path — Editar archivos .xlsx cerrados directamente usando Python puro (preserva imágenes, gráficos y todo el contenido incrustado)

Herramientas

Herramienta	Libro de trabajo	Ruta	Requerido
get_excel_info	-	-	(ninguno)
read_cells	OK	OK	range
write_cells	OK	OK	range, value
format_cells	OK	OK	range, format
execute_vba	OK	-	workbook, code

Requisitos

• Node.js 18+
• Python 3.8+
• xlwings (para el modo de Excel en vivo — pip install xlwings)
• Microsoft Excel (solo necesario para el modo workbook y execute_vba)

Funciona en Windows y macOS. El modo path también funciona en Linux.

Instalación

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

Configurar el cliente MCP

Añade a la configuración de tu cliente MCP (Claude Desktop, Cursor, etc.):

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

Para usar un ejecutable de Python específico, establece la variable de entorno 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

Archivos cerrados (modo ruta)

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

No se requiere instalación de Excel. Las imágenes, gráficos y formas se conservan.

Libros de trabajo abiertos (modo libro de trabajo)

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"

Requiere que Excel esté ejecutándose con el libro de trabajo abierto.

Licencia

MIT