Google Forms MCP 服务器

此 MCP 服务器使用 Google Forms API 来提供诸如创建、编辑和检索表单响应等功能。

构建方法

初始设置

克隆仓库后，安装依赖项

cd google-forms-mcp

构建服务器

# 构建主 MCP 服务器
npm run build

构建刷新令牌获取脚本

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

在开发环境中执行

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

# 或者，使用 npm 脚本
npm run start

设置方法

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

   • https://console.cloud.google.com/
   • 从 APIs & Services > Library 中搜索 "Google Forms API" 并启用它。

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

   • APIs & Services > Credentials > Create Credentials > OAuth client ID
   • 选择 Application type: "Desktop app"

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 服务器提供以下工具：

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

使用示例

创建一个表单并添加一些问题。

Claude 使用如下 MCP 工具来创建表单：

1. 使用 create_form 工具创建一个新表单
2. 使用 add_text_question 或 add_multiple_choice_question 工具添加问题
3. 显示创建的表单的 URL