Skip to main content
Glama
joseignaciom5

MCP Excel-PostgreSQL

README.md
# MCP Excel-PostgreSQL

Este servidor implementa el **Model Context Protocol (MCP)** para conectar asistentes de IA (como Claude Desktop) con tus datos locales. Permite leer y editar archivos **Excel** y realizar consultas a bases de datos **PostgreSQL** de forma segura y directa, facilitando flujos de trabajo de análisis de datos sin necesidad de exportaciones manuales.

## Instalación

1. Clona el repositorio e instala las dependencias:
   ```bash
   npm install
   ```

2. Compila el servidor (genera los archivos en `dist/`):
   ```bash
   npm run build
   ```

## Configuración para Claude Desktop

Agregar a tu configuración MCP (`~/.MPC/mcp.json` o Claude Desktop config):

```json
{
  "mcpServers": {
    "excel-mcp-server": {
      "command": "node",
      "args": ["/path/to/your/project/dist/main.js"],
      "cwd": "/path/to/your/project",
      "env": {
        "POSTGRES_USER": "your_user",
        "POSTGRES_HOST": "localhost",
        "POSTGRES_DB": "your_db",
        "POSTGRES_PASSWORD": "your_password",
        "POSTGRES_PORT": "5432"
      }
    }
  }
}
```

## Herramientas disponibles

**Excel:** read_excel, write_excel, update_excel

**PostgreSQL:** connect_database, execute_query, create_table, insert_data, list_tables, describe_table, get_database_info

**Integración:** export_to_excel, import_from_excel

TDQS

B3.3/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have completely distinct purposes: one reads Excel files, the other writes them. There is no possibility of confusion between read_excel and write_excel.

Naming Consistency5/5

Both tools follow a clear verb_excel pattern (read, write), making the naming predictable and consistent.

Tool Count2/5

Only 2 tools are provided, which is too few given the server name 'Excel-PostgreSQL' implies handling both Excel and PostgreSQL data. Even ignoring the PostgreSQL part, basic Excel operations like listing sheets or modifying specific cells are missing.

Completeness1/5

The tool surface is severely incomplete for a server claiming to cover both Excel and PostgreSQL. With only read and write for Excel, and no PostgreSQL tools at all, agents will lack essential capabilities.

Maintenance

ActivityInactive
ResponsivenessNo issues