Google 表单 MCP 服务器

此 MCP 服务器使用 Google 表单 API 提供创建、编辑表单以及获取回复等功能。

构建方法

初始设置

克隆存储库后，安装依赖项

cd google-forms-server
npm install

构建服务器

# 构建主 MCP 服务器
npm run build

构建刷新令牌获取脚本

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

在开发环境中运行

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

# 或者，使用 npm script
npm run start

设置方法

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

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

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

   • API 和服务 > 凭据 > 创建凭据 > OAuth 客户端 ID
   • 应用程序类型：选择“桌面应用”

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

   export GOOGLE_CLIENT_ID="你的客户端ID"
   export GOOGLE_CLIENT_SECRET="你的客户端密钥"
   cd google-forms-server
   npm run build
   node build/get-refresh-token.js
   

   注意: 如果在执行 get-refresh-token.js 时发生错误，请执行以下命令：

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

4. 复制显示出来的刷新令牌。

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

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

   "google-forms-server": {
     "command": "node",
     "args": [
       "/Users/nakamotomasatoshi/application/AI/mcp-google-form/google-forms-server/build/index.js"
     ],
     "env": {
       "GOOGLE_CLIENT_ID": "你的客户端ID",
       "GOOGLE_CLIENT_SECRET": "你的客户端密钥",
       "GOOGLE_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