MCPApp

Uma rede MCP baseada em Google Apps Script que permite que a IA acesse com segurança dados do Google Workspace, como Gmail e Calendário.

GitHub
50
Experimente este MCPPatrocinado

Documentação

MCPApp

MIT License

MseeP.ai Security Assessment Badge

🚀 Anúncio Especial: Integrado com GASADK!

MCPApp agora é totalmente suportado e pode ser usado diretamente do GASADK (Google Apps Script Agent Development Kit). O GASADK fornece uma estrutura abrangente para construir sistemas multiagentes poderosos e utilizar ferramentas MCP de forma integrada no Google Apps Script.

👉 Confira o GASADK no GitHub para impulsionar seu desenvolvimento!

Visão Geral

O Model Context Protocol (MCP) é um padrão emergente projetado para funcionar como um adaptador universal, permitindo que aplicações de IA se conectem de forma integrada e segura a sistemas externos e fontes de dados. O objetivo principal do MCP é fornecer um método padronizado para que modelos de IA solicitem e recebam informações contextualmente relevantes, o que é crucial para executar tarefas complexas.

Este repositório apresenta duas direções:

  1. Um servidor MCP construído com Google Apps Script para Gemini CLI e outros clientes MCP.
  2. Uma rede MCP construída com Google Apps Script.

Exemplos de comandos curl para testar o 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>}}}'

Licença

MIT

Autor

Tanaike

Doar

Histórico de Atualizações

  • v1.0.0 (8 de maio de 2025)

    1. Lançamento inicial.

  • v1.0.1 (9 de maio de 2025)

    1. Um bug no registro de logs foi removido.

  • v1.0.2 (29 de maio de 2025)

    1. A partir da v1.0.2, para usar o MCPApp como biblioteca, o LockService é fornecido.

  • v2.0.0 (12 de junho de 2025)

    1. A partir da v2.0.0, tanto o cliente MCP quanto o servidor MCP podem ser construídos com Google Apps Script.

  • v2.0.1 (18 de junho de 2025)

    1. Um bug foi removido.

  • v2.0.2 (19 de junho de 2025)

    1. Um bug foi removido.

  • v2.0.3 (1 de julho de 2025)

    1. Um bug foi removido.

  • v2.0.4 (2 de julho de 2025)

    1. Um bug foi removido.

  • v2.0.5 (31 de julho de 2025)

    1. Um bug foi removido.

  • v2.0.6 (1 de agosto de 2025)

    1. O método "prompts/get" foi atualizado.

  • v2.0.7 (6 de agosto de 2025)

    1. A partir da v2.0.7, agora você pode ativar ou desativar seletivamente o LockService.
    • Por padrão, esta biblioteca é executada com o LockService ativado. Para desativá-lo, basta modificar return new MCPApp.mcpApp({ accessKey: "sample" }) para return new MCPApp.mcpApp({ accessKey: "sample", lock: false }).
    • Quando o LockService está desativado (lock: false), solicitações assíncronas de clientes como o Gemini CLI podem apresentar um aumento na velocidade de processamento. No entanto, é importante observar que o número máximo de solicitações simultâneas não deve exceder 30. Use esta opção com cautela.

  • v2.0.8 (6 de agosto de 2025)

    1. Um bug foi removido.

  • v2.0.10 (9 de maio de 2026)

    1. MCPApp refatorado.

  • v2.0.11 (9 de maio de 2026)

    1. Um bug foi removido.

  • v2.1.0 (10 de maio de 2026)

    1. Um bug foi removido.

  • v2.1.1 (12 de maio de 2026)

    1. Um bug foi removido.

  • v2.1.2 (12 de maio de 2026)

    1. Modificado

  • v2.1.7 (15 de maio de 2026)

    1. Vários bugs foram removidos.

  • v2.2.0 (19 de maio de 2026)

    1. const mcpServers = ["mcp-url-1", { "mcp-server-name": { "httpUrl": "https://mcp-url-2", "headers": { "key": "value" } } }] pode ser usado para utilizar servidores MCP.

  • v2.3.0 (10 de junho de 2026)

    1. Adicionado registro de logs em planilhas multicanal. Quando um ID de planilha é especificado, os logs são armazenados na planilha "MCP"; caso contrário, a planilha "log" é usada. Os cabeçalhos ["Date", "Method", "ID", "Direction", "Message"] são criados automaticamente com formatação, e as planilhas são inicializadas de forma segura para threads sob o bloqueio do LockService.
    2. Mensagens de erro aprimoradas com prefixo [MCP Server Error] ou [MCP Client Error] para simplificar a depuração.

  • v2.4.0 (24 de junho de 2026)

    1. Modelo padrão atualizado para models/gemini-3.1-flash-lite.
    2. Integrada a compatibilidade com GasHookManager para suportar hooks BeforeTool e AfterTool no lado do servidor MCP.

TOPO