🚀 Google 表单 MCP 服务器

本 MCP 服务器借助 Google Forms API，提供创建、编辑和检索表单响应等功能，可高效处理 Google 表单相关操作。

🚀 快速开始

📦 安装指南

初始设置

克隆仓库后，需安装依赖项，可通过以下命令进入项目目录：

cd google-forms-mcp

构建服务器

使用以下命令构建主要的 MCP 服务器：

# 构建主要的 MCP 服务器
npm run build

构建刷新令牌获取脚本

运行以下命令构建刷新令牌获取脚本：

# 构建刷新令牌获取脚本
npm run build:token

开发环境中的执行

可选择以下任意一种方式在开发环境中启动服务器：

# 直接运行服务器
node build/index.js

# 或使用 npm 脚本
npm run start

⚙️ 设置方法

1. 在 Google Cloud Console 中创建项目并启用 Google Forms API

   • 访问 Google Cloud Console。
   • 从 APIs & Services > Library 搜索 "Google Forms API" 并启用它。

2. 获取 OAuth 2.0 客户端 ID 和密钥

   • 进入 APIs & Services > Credentials > 创建凭证 > OAuth 客户端 ID。
   • 选择应用程序类型为 "桌面应用"。

3. 设置环境变量并获取刷新令牌

   export GOOGLE_CLIENT_ID="YOUR_CLIENT_ID"
   export GOOGLE_CLIENT_SECRET="YOUR_CLIENT_SECRET"
   cd google-forms-mcp
   npm run build
   node build/get-refresh-token.js
   

   ⚠️ 重要提示

   如果运行 get-refresh-token.js 时出现错误，请执行以下命令：

   cd google-forms-mcp
   npm run build:token
   node build/get-refresh-token.js
   

4. 复制显示的刷新令牌

5. 更新 Claude 桌面应用程序的配置文件

   • 打开 ~/Library/Application Support/Claude/claude_desktop_config.json。
   • 在 mcpServers 部分的 google-forms-mcp 中添加环境变量：

   "google-forms-mcp": {
     "command": "node",
     "args": [
       "/path/to/your/google-forms-mcp/build/index.js" # 更新此路径
     ],
     "env": {
       "GOOGLE_CLIENT_ID": "YOUR_CLIENT_ID",
       "GOOGLE_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
       "GOOGLE_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN"
     }
   }
   

6. 重启 Claude 桌面应用程序

✨ 主要特性

此 MCP 服务器提供了一系列实用工具，可方便地操作 Google 表单：

1. create_form - 创建新的 Google 表单
2. add_text_question - 在表单中添加文本问题
3. add_multiple_choice_question - 在表单中添加多项选择问题
4. get_form - 获取表单详细信息
5. get_form_responses - 获取表单响应