Código de exemplo do livro sobre Claude Code

Crie e edite Google Forms conversando com o Claude

mcp-server-google-forms é um servidor MCP local, em Node.js, com 15 ferramentas para o Claude criar formulários completos numa única operação, montar quizzes com gabarito, organizar seções, publicar e ler respostas — tudo pela conversa.

• Ver no GitHub
• Pacote no npm
• Revisão de código
• Política de privacidade
• Termos de uso

Onde ele está publicado

• npm — instale com um comando, sem clonar nada: mcp-server-google-forms.
• MCP Registry oficial (da Anthropic e da comunidade MCP) — registrado como io.github.claude-book/mcp-server-google-forms.
• Zenodo (CERN) — cada versão é arquivada com DOI permanente; citável em trabalhos acadêmicos.

Como funciona

O servidor roda no seu computador e conversa com a API oficial do Google Forms usando uma autorização que só você concede — com os escopos mínimos (formulários e leitura de respostas; nada de acesso ao Drive inteiro). Nenhum dado passa por servidores de terceiros: é a sua máquina falando diretamente com o Google.

O que ele faz (15 ferramentas)

• Criar — build_form monta o formulário inteiro numa única operação (título, descrição, quiz e até 50 perguntas); create_form cria um vazio.
• Perguntar — add_question com 9 tipos: texto curto e longo, escolha única, caixas de seleção, lista suspensa, escala linear, data, hora/duração e avaliação (estrelas, corações, joinhas).
• Organizar — seções (add_section), blocos de texto (add_text_item), mover (move_question) e apagar (delete_question) com validação de posição.
• Editar sem recriar — update_question e update_form_info preservam o vínculo com respostas já recebidas.
• Quiz de verdade — pontos e gabarito por pergunta (set_quiz), com auditoria pós-criação (verify_answer_keys).
• Publicar e acompanhar — set_publish, get_form (resumo legível) e list_responses (paginada).
• Diagnóstico — auth_status testa as credenciais direto com o Google.

E quando algo dá errado, as mensagens explicam o que fazer, em português — nada de erro técnico cru.

Manual: comece a usar

Antes de tudo (uma vez): o projeto no Google Cloud

1. Em console.cloud.google.com, crie um projeto e ative a Google Forms API.
2. Crie credenciais OAuth do tipo “App para computador” e baixe o arquivo client_secret*.json.

Caminho A — via npm (recomendado)

1. Coloque o client_secret*.json na pasta ~/.config/mcp-server-google-forms/ (crie-a se não existir).
2. Autorize com o Google: npx -p mcp-server-google-forms mcp-server-google-forms-token
3. Registre no Claude Code: claude mcp add google-forms -- npx mcp-server-google-forms

Caminho B — via clone do repositório

1. Clone o repositório e rode npm install.
2. Coloque o client_secret*.json na pasta credentials/.
3. Rode npm run token e autorize no navegador.
4. Registre no Claude Code: claude mcp add google-forms -- node "$(pwd)/src/server.js"

Pronto: peça ao Claude, por exemplo, “crie um quiz de 5 perguntas sobre fotossíntese, valendo 2 pontos cada, e me dê o link”. O passo a passo completo, com solução de problemas, está no README.

Para citar em trabalhos acadêmicos

Alvarenga da Silva, H. (2026). mcp-server-google-forms: servidor MCP para Google Forms. Zenodo. https://doi.org/10.5281/zenodo.21296975