MCPApp

Una red MCP basada en Google Apps Script que permite a la IA acceder de forma segura a datos de Google Workspace como Gmail y Calendar.

Documentación

MCPApp

MIT License

MseeP.ai Security Assessment Badge


🚀 Anuncio Especial: ¡Integrado con GASADK!

MCPApp ahora es totalmente compatible y se puede usar directamente desde GASADK (Google Apps Script Agent Development Kit). GASADK proporciona un marco integral para construir sistemas multiagente potentes y utilizar herramientas MCP sin problemas en Google Apps Script.

👉 ¡Consulta GASADK en GitHub para impulsar tu desarrollo!


Resumen

El Protocolo de Contexto de Modelo (MCP) es un estándar emergente diseñado para funcionar como un adaptador universal, permitiendo que las aplicaciones de IA se conecten de manera fluida y segura con sistemas externos y fuentes de datos. El propósito central de MCP es proporcionar un método estandarizado para que los modelos de IA soliciten y reciban información contextualmente relevante, lo cual es crucial para realizar tareas complejas.

Este repositorio presenta dos direcciones:

  1. Un servidor MCP construido con Google Apps Script para Gemini CLI y otros clientes MCP.
  2. Una red MCP construida con Google Apps Script.

Comandos curl de ejemplo para probar el servidor MCP

initialize

curl -L "<YOUR_MCP_SERVER_URL>" -d '{"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"sample-mcp-client","version":"0.0.0"}},"jsonrpc":"2.0","id":0}'

tools/list

curl -L "<YOUR_MCP_SERVER_URL>" -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

prompts/list

curl -L "<YOUR_MCP_SERVER_URL>" -d '{"jsonrpc":"2.0","id":1,"method":"prompts/list","params":{}}'

tools/call

curl -L "<YOUR_MCP_SERVER_URL>" -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"<TOOL_NAME>","arguments":{<ARGUMENTS_FOR_TOOL>}}}'

Licencia

MIT

Autor

Tanaike

Donar

Historial de Actualizaciones

  • v1.0.0 (8 de mayo de 2025)

    1. Lanzamiento inicial.
  • v1.0.1 (9 de mayo de 2025)

    1. Se corrigió un error en el registro (logging).
  • v1.0.2 (29 de mayo de 2025)

    1. A partir de v1.0.2, para usar MCPApp como biblioteca, se proporciona LockService.
  • v2.0.0 (12 de junio de 2025)

    1. A partir de v2.0.0, tanto el cliente MCP como el servidor MCP pueden construirse con Google Apps Script.
  • v2.0.1 (18 de junio de 2025)

    1. Se corrigió un error.
  • v2.0.2 (19 de junio de 2025)

    1. Se corrigió un error.
  • v2.0.3 (1 de julio de 2025)

    1. Se corrigió un error.
  • v2.0.4 (2 de julio de 2025)

    1. Se corrigió un error.
  • v2.0.5 (31 de julio de 2025)

    1. Se corrigió un error.
  • v2.0.6 (1 de agosto de 2025)

    1. Se actualizó el método "prompts/get".
  • v2.0.7 (6 de agosto de 2025)

    1. A partir de v2.0.7, ahora puedes habilitar o deshabilitar selectivamente el LockService.
    • De forma predeterminada, esta biblioteca se ejecuta con LockService habilitado. Para deshabilitarlo, simplemente modifica return new MCPApp.mcpApp({ accessKey: "sample" }) a return new MCPApp.mcpApp({ accessKey: "sample", lock: false }).
    • Cuando LockService está deshabilitado (lock: false), las solicitudes asíncronas de clientes como Gemini CLI pueden experimentar un aumento en la velocidad de procesamiento. Sin embargo, es importante tener en cuenta que el número máximo de solicitudes concurrentes no debe exceder de 30. Usa esta opción con precaución.
  • v2.0.8 (6 de agosto de 2025)

    1. Se corrigió un error.
  • v2.0.10 (9 de mayo de 2026)

    1. Se refactorizó MCPApp.
  • v2.0.11 (9 de mayo de 2026)

    1. Se corrigió un error.
  • v2.1.0 (10 de mayo de 2026)

    1. Se corrigió un error.
  • v2.1.1 (12 de mayo de 2026)

    1. Se corrigió un error.
  • v2.1.2 (12 de mayo de 2026)

    1. Modificado
  • v2.1.7 (15 de mayo de 2026)

    1. Se corrigieron varios errores.
  • v2.2.0 (19 de mayo de 2026)

    1. const mcpServers = ["mcp-url-1", { "mcp-server-name": { "httpUrl": "https://mcp-url-2", "headers": { "key": "value" } } }] se puede usar para utilizar servidores MCP.
  • v2.3.0 (10 de junio de 2026)

    1. Se añadió registro de hojas multicanal. Cuando se especifica un ID de hoja de cálculo, los registros se almacenan en la hoja "MCP"; de lo contrario, se usa la hoja "log". Los encabezados ["Date", "Method", "ID", "Direction", "Message"] se crean automáticamente con formato, y las hojas se inicializan de manera segura para subprocesos bajo el bloqueo de LockService.
    2. Se mejoraron los mensajes de error con el prefijo [MCP Server Error] o [MCP Client Error] para simplificar la depuración.
  • v2.4.0 (24 de junio de 2026)

    1. Se actualizó el modelo predeterminado a models/gemini-3.1-flash-lite.
    2. Se integró la compatibilidad con GasHookManager para admitir hooks BeforeTool y AfterTool en el lado del servidor MCP.

ARRIBA