Google 表单 MCP 服务器

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

构建方法

初始设置

克隆仓库后安装依赖项

cd google-forms-mcp

构建服务器

# 构建主 MCP 服务器
npm run build

构建刷新令牌获取脚本

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

开发环境执行

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

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

设置方法

1. 在 Google Cloud 控制台中创建一个项目并启用 Google 表单 API。

   • https://console.cloud.google.com/
   • 从“API 和服务”>“库”搜索“Google 表单 API”并启用它。

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

   • “API 和服务”>“凭据”>“创建凭据”>“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 服务器提供以下工具：

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