mcpField
M
mcp-google-forms

mcp-google-forms

本地服务
github.com/KamaruSama生产力027 周前更新
代码仓库

关于 mcp-google-forms

mcp-google-forms 是用于创建、编辑和查看 Google Forms 的 MCP 服务，面向兼容 MCP 的客户端，涵盖测验设置、题目管理和答卷读取。

主要功能

  1. 01创建并配置测验表单
  2. 02添加选择题、文本题和判断题
  3. 03编辑、排序和删除题目
  4. 04核对答案键
  5. 05读取表单答卷
  6. 06发送原始 Forms API 更新

适用场景

  1. 01创建测验并设置答案键
  2. 02修改题目内容或顺序
  3. 03查看已提交的表单答卷

MCP 相关

向 MCP 客户端提供 19 个工具，用于管理 Google Forms，包括创建和编辑表单、操作题目及读取答卷。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "kamarusama-mcp-google-forms": {
      "command": "uvx",
      "args": [
        "mcp-google-forms"
      ],
      "env": {
        "GOOGLE_FORMS_MCP_DIR": "<GOOGLE_FORMS_MCP_DIR>"
      }
    }
  }
}
启动命令uvx mcp-google-forms
需要配置的环境变量
GOOGLE_FORMS_MCP_DIROverride the directory where OAuth credentials.json and token.json are stored (default: ~/.config/google-forms-mcp).

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypimcp-google-forms1.0.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp-google-forms

用于管理 Google Forms 的 MCP 服务——测验、评分、图片和回复。

通过模型上下文协议提供 19 个工具，用于创建、编辑、检查和管理 Google Forms。适用于 Claude Code、Claude Desktop 或任何兼容 MCP 的客户端。

📖 阅读泰语版 →

工具一览

部分工具用途
身份验证auth_status检查 OAuth 凭据状态
创建 / 元数据create_quiz_form创建新的测验模式表单
rename_form更改标题 / 描述
set_quiz_mode开启 / 关闭测验模式
读取get_form完整表单 JSON
list_questions简洁的项目列表
verify_answer_keys比较当前答案与预期答案
添加add_true_false_question单个判断题
batch_add_true_false批量添加判断题
add_multiple_choice_question单选 / 复选 / 下拉菜单
add_text_question简答或段落文本
add_section_header分页符 / 分区
编辑update_question_title重命名问题
update_true_false_answer更改判断题答案
delete_question移除项目
move_question重新排序
回复list_responses所有已提交的回复
get_response按 ID 获取单条回复
备用接口raw_batch_update原始 Forms API 调用

安装

1. 启用 API 并获取凭据
  1. 访问 https://console.cloud.google.com → 创建 / 选择项目
  2. API 和服务 → 库 → 启用 Google Forms API
  3. OAuth 同意屏幕 → 外部 → 将自己添加为测试用户
  4. 凭据 → 创建凭据 → OAuth 客户端 ID → 桌面应用
  5. 下载 JSON → 保存为： 
    ~/.config/google-forms-mcp/credentials.json
2. 注册到 Claude Code
claude mcp add google-forms -s user -- \
  uv run --directory /path/to/mcp-google-forms python server.py
3. 首次使用

首次调用工具时，服务会打开浏览器以进行 OAuth 授权。令牌会缓存到 ~/.config/google-forms-mcp/token.json。

权限范围

  • forms.body — 创建 / 编辑表单结构
  • forms.responses.readonly — 读取回复
  • drive.file — 通过 Drive 附加图片

支持本项目 ❤

如果此工具对你的工作流有所帮助，可以考虑支持开发：

联系方式

Copyright © 2026 likezara™。保留所有权利。 由 Kamaru（笔名）开发。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。