Servidor MCP de Microsoft 365

💡 Descripción

Actualmente, esto es un trabajo en progreso y más una prueba de concepto que una solución. El objetivo es crear un servidor MCP que permita ejecutar cualquier tipo de CLI para comandos de Microsoft 365.

📦 Requisitos previos

Node.js 20.x o superior

🚀 Cómo construir y ejecutar

Antes de cualquier cosa, primero ejecute npm install para instalar todas las dependencias.

Luego, para construir el proyecto, ejecute:

npm run build

Para probar esta herramienta, deberá crear un requisito de aplicación de Entra y un certificado para que este servidor MCP pueda autenticarse en Microsoft 365 como una aplicación. Para crear un certificado y el requisito de aplicación con los ámbitos necesarios y agregarlo a su inquilino junto con el certificado, ejecute el script createApp.ps1 y siga las instrucciones. La mayoría de los elementos puede dejarlos vacíos al crear el certificado, excepto la contraseña. La contraseña es necesaria. Como el script usa CLI para Microsoft 365 para crear el requisito de aplicación y otros elementos, primero deberá instalar CLI para Microsoft 365 globalmente usando npm i -g @pnp/cli-microsoft365 e iniciar sesión en su inquilino como administrador. Después de ejecutar el script, debería ver un registro de aplicación 'MCP Server Test' en su ID de Entra con los ámbitos y el certificado necesarios. También debería ver el archivo del certificado y el certificado exportado codificado en base64 en la carpeta temp . Los necesitará más adelante.

Ejecución de MCP mediante el inspector

Una forma de probar el servidor MCP de M365 es usar el Inspector de MCP . Primero, inicie el servidor MCP de M365 con el comando:

npm run start

Ahora, para ejecutar el inspector para su servidor MCP y también pasar los parámetros necesarios como entorno para que el servidor MCP pueda recogerlos y usarlos para autenticarse en Microsoft 365, puede ejecutar el siguiente comando:

npx @modelcontextprotocol/inspector -e CertificatePassword='YOUR_PASSOWRD' -e AppId='ENTRA_APP_REG_ID' -e TenantId='TENANT_ID' -e TenantUrl='TENANT_URL' -e CertificateBase64Encoded='BASE64_ENCODED_VALUE_OF_YOUR_CERT' node dist/index.js

Después, espere a que se inicie el inspector y ábralo en su navegador. Debería ver el servidor MCP ejecutándose y podrá consultar las herramientas y ejecutarlas localmente.

Ejecución de MCP en VS Code

También es posible ejecutar el servidor MCP en VS Code desde la compilación local para que lo use el agente de GitHub Copilot. Por ahora, esto solo es compatible con los usuarios de VS Code Insiders. Primero, inicie el servidor MCP de M365 con el comando:

npm run start

Ahora, ve al modo Agente Copilot de GitHub de VS Code, haz clic en el ícono de herramientas y selecciona Add more tools . Luego, selecciona Add MCP server y, a continuación, Command (stdio) e introduce el siguiente comando:

node FULL_PATH_TO_YOUR_PROJECT/dist/index.js

Pulsa Enter y nómbralo como quieras. Se recomienda añadirlo al ámbito workspace para realizar pruebas. Después, abre el archivo .vscode/mcp.json y modifícalo para pasar las variables de entorno necesarias para la autenticación.

{
    "servers": {
        "m365-mcp-server": {
            "type": "stdio",
            "command": "node",
            "args": [
                "FULL_PATH_TO_YOUR_PROJECT/dist/index.js" // e.g. C:/workspace/repo/microsoft-365-mcp-server/dist/index.js
            ],
            "env": {
                "CertificateBase64Encoded": "BASE64_ENCODED_VALUE_OF_YOUR_CERT",
                "CertificatePassword": "YOUR_PASSOWRD",
                "AppId": "ENTRA_APP_REG_ID",
                "TenantId": "TENANT_ID",
                "TenantUrl": "TENANT_URL" // e.g. https://tenanttocheck.sharepoint.com/
            }
        }
    }
}

Haz clic en "Iniciar" y verás 4 nuevas herramientas añadidas a tu agente de GitHub Copilot. Pruébalas.

🎬 Demostración

👉 Película 🎬

Microsoft 365 MCP Server