Microsoft Project MCP Server (msproject-mcp)

Servidor Model Context Protocol (MCP) para controlar, automatizar y consultar Microsoft Project de escritorio (archivos .mpp y .xml) en tiempo real mediante asistentes de inteligencia artificial (Claude, Cursor, Antigravity, VS Code, etc.).

A diferencia de lectores estáticos de archivos, este servidor interactúa directamente con la aplicación de escritorio de MS Project mediante la API COM nativa de Windows (win32com), permitiendo ver los cambios en pantalla en vivo, recalcular cronogramas, asignar recursos y exportar resultados.

🌟 Características Principales

• 🔄 Control Total de Proyectos: Crear, abrir, activar, guardar y cerrar archivos .mpp y .xml.

• 📋 Gestión de Tareas y EDT / WBS: Creación de tareas con duraciones, fechas, sangrías jerárquicas (indent_task), hitos y vinculación de dependencias (predecessors).

• 👥 Gestión de Recursos y Costos: Alta y asignación de recursos de tipo Trabajo, Material y Costo, con tarifas por hora y asignación de unidades.

• 📈 Ruta Crítica y Línea Base: Fijación de líneas base (BaselineSave), cálculo instantáneo de la ruta crítica y reportes de estado con desviaciones y tareas atrasadas.

• 🌐 Soporte Bilingüe Automático: Compatible tanto con Microsoft Project en español como en inglés (normaliza automáticamente duraciones como 1w a 1s y predecesoras como FS a FC).

• 📄 Exportación a PDF: Generación directa de reportes en PDF del cronograma.

Related MCP server: MCP Outlook

📋 Requisitos del Sistema

Para ejecutar este servidor MCP se requiere:

1. Sistema Operativo: Windows 10 o Windows 11.

2. Microsoft Project: Instalación de escritorio de MS Project (versiones 2016, 2019, 2021 o Microsoft 365 Project).

3. Python: Versión 3.10 o superior (recomendado instalar con uv o desde python.org).

🚀 Instalación y Puesta en Marcha

Opción 1: Con uv (Recomendado - Rápido)

1. Clonar el repositorio:

   git clone https://github.com/CamiLoP19/msproject-mcp.git
   cd msproject-mcp

2. Crear el entorno e instalar dependencias:

   uv venv
   .venv\Scripts\activate
   uv sync

Opción 2: Con pip y Python estándar

1. Clonar el repositorio:

   git clone https://github.com/CamiLoP19/msproject-mcp.git
   cd msproject-mcp

2. Crear y activar el entorno virtual:

   python -m venv .venv
   .venv\Scripts\activate

3. Instalar dependencias:

   pip install -e .

⚙️ Configuración en Clientes de IA

Copia la configuración correspondiente según la herramienta que utilices.

1. Claude Desktop

Abre tu archivo de configuración en %APPDATA%\Claude\claude_desktop_config.json y añade:

{
  "mcpServers": {
    "msproject": {
      "command": "C:\\ruta\\a\\tu\\msproject-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "msproject_mcp"],
      "env": {
        "MSPROJECT_VISIBLE": "1"
      }
    }
  }
}

2. Cursor

En Cursor, abre Settings > Features > MCP o edita el archivo ~/.cursor/mcp.json:

{
  "mcpServers": {
    "msproject": {
      "command": "C:\\ruta\\a\\tu\\msproject-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "msproject_mcp"],
      "env": {
        "MSPROJECT_VISIBLE": "1"
      }
    }
  }
}

3. VS Code (Cline / Roo Code / Continue)

En los ajustes de extensiones MCP de VS Code:

{
  "mcpServers": {
    "msproject": {
      "command": "C:\\ruta\\a\\tu\\msproject-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "msproject_mcp"],
      "env": {
        "MSPROJECT_VISIBLE": "1"
      }
    }
  }
}

4. Antigravity IDE

Crea o edita el archivo .agents/mcp_config.json en la raíz de tu espacio de trabajo:

{
  "mcpServers": {
    "msproject": {
      "command": "C:\\ruta\\a\\tu\\msproject-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "msproject_mcp"],
      "env": {
        "MSPROJECT_VISIBLE": "1"
      }
    }
  }
}

Nota: Reemplaza C:\\ruta\\a\\tu\\msproject-mcp con la ruta absoluta donde clonaste el repositorio en tu PC.

🛠️ Herramientas Disponibles (25 Herramientas)

📂 Proyectos

📝 Tareas y Esquema (EDT / WBS)

👤 Recursos y Asignaciones

📊 Seguimiento y Control

🧪 Pruebas y Verificación

El repositorio incluye un conjunto de pruebas para validar la conexión COM con MS Project:

# Ejecutar prueba de extremo a extremo:
python tests\smoke_test.py

Esta prueba abrirá Microsoft Project, creará un proyecto de prueba, estructurará tareas jerárquicas, asignará recursos, guardará línea base, calculará la ruta crítica y guardará el archivo .mpp.

🔧 Variables de Entorno

• MSPROJECT_VISIBLE: 1 (por defecto) para mantener la ventana de Project visible en pantalla, o 0 para ejecutarlo en segundo plano.

• MSPROJECT_TIMEOUT: Tiempo límite en segundos para llamadas COM (por defecto 90).

📄 Licencia

Este proyecto se distribuye bajo la licencia MIT. Consulta el archivo LICENSE para más detalles.