📊 Servidor MCP para archivos Excel con macros (.xlsm)

by orlando2019

1 stars
98 downloads
Not rated
GitHub

About

Este servidor implementa el Model Context Protocol (MCP) para manipular archivos Excel que contienen macros (.xlsm). Utiliza el protocolo stdio para la comunicación, lo que permite integrarse fácilmente con clientes MCP como Claude.

Details

Author
orlando2019
GitHub stars
1
Downloads
98
Categories
Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name 📊 Servidor MCP para archivos Excel con macros (.xlsm)
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via pip (pip install xlsm-mcp-server) or with uv (recommended). Run directly with python -m xlsm_mcp or from a virtual environment. Configure in MCP client settings (e.g., Claude Desktop's settings.json) by specifying the command python and args ["-m", "xlsm_mcp"].

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "\ud83d\udcca servidor mcp para archivos excel con macros (.xlsm)": {
            "xlsm-mcp-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

McpServers

{
    "xlsm-mcp-server": {
        "command": "uv",
        "args": [
            "venv"
        ]
    }
}

📊 Servidor MCP para archivos Excel con macros (.xlsm)

Autor: Orlando Ospino (orlando2019)

Este servidor implementa el Model Context Protocol (MCP) para manipular archivos Excel que contienen macros (.xlsm). Utiliza el protocolo stdio para la comunicación, lo que permite integrarse fácilmente con clientes MCP como Claude Desktop, Cursor o Windsurf.

🌟 ¿Qué es MCP?

MCP (Model Context Protocol) es un protocolo que permite a los modelos de lenguaje interactuar con herramientas externas. Con este servidor, Claude y otros asistentes AI pueden manipular archivos Excel con macros de forma nativa, ampliando sus capacidades para ayudar en tareas de análisis de datos y automatización de oficina.

✨ Características

- Creación y manipulación de archivos Excel con macros (.xlsm)
- Lectura y escritura de datos en hojas de cálculo
- Gestión de hojas (crear, eliminar, renombrar)
- Listar y obtener información de macros VBA
- Aplicar formato a rangos de celdas
- Compatible con Python 3.10+
- Integración sencilla con entornos virtuales y clientes MCP modernos

🔧 Instalación

Usando pip

pip install xlsm-mcp-server

Usando uv (recomendado)

uv venv
.venv\Scripts\activate
uv pip install -r requirements.txt

📝 Uso

Ejecución directa

python -m xlsm_mcp
O, si usas un entorno virtual:
.venv\Scripts\python.exe -m xlsm_mcp

Configuración para Claude Desktop, Cursor o Windsurf

Agrega a tu configuración (por ejemplo, settings.json):

"mcpServers": {
  "xlsm": {
    "command": "python",
    "args": ["-m", "xlsm_mcp"],
    "transport": "stdio"
  }
}
- Puedes omitir "transport": "stdio" en algunos clientes, pero es recomendable dejarlo para máxima compatibilidad. - Si usas un entorno virtual, reemplaza "python" por la ruta a tu ejecutable Python.

Argumentos avanzados

Puedes agregar argumentos personalizados en la sección "args" según lo requiera tu servidor, por ejemplo:

"args": ["-m", "xlsm_mcp", "--log-level", "DEBUG"]

🛠️ Herramientas disponibles

- read_data_from_excel: Lee datos de una hoja de Excel
- write_data_to_excel: Escribe datos en una hoja de Excel
- create_new_workbook: Crea un nuevo libro de Excel con opción de habilitar macros
- create_new_worksheet: Crea una nueva hoja en un libro de Excel existente
- get_workbook_metadata: Obtiene metadatos del libro, incluyendo información sobre macros
- list_macros_in_workbook: Lista todas las macros disponibles en un libro
- get_macro_details: Obtiene información detallada sobre una macro específica
- format_cell_range: Aplica formato a un rango de celdas

💡 Ejemplos

Leer datos de un archivo Excel

```python

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.