SurveyMonkey API 服务器

SurveyMonkey API v3的MCP服务器,提供用户、调查、页面、问题、响应、收集器、联系人等功能,适用于调查数据管理和分析。

  • by dscovr
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 dscovr/surveymonkey-mcp

使用说明

麦肯锡调查

MCP服务器 SurveyMonkey API v3.

公开SurveyMonkey作为可从Claude和任何MCP兼容客户端使用的工具。

特性

  • 用户 --获取当前用户配置文件
  • 调查 --列表、获取、获取详细信息、创建、更新、修补、删除
  • 页面 --列表、获取、创建、更新、删除
  • 问题 --列表、获取、创建、更新、删除
  • 回复 --列表(元数据)、列表批量(带答案)、获取、获取详细信息、删除、导出CSV
  • 收集器 --列表、获取、创建、更新、删除
  • 收集器消息 --列表、创建、发送
  • 收款人 --列表
  • 网络钩子 --列表、获取、创建、更新、删除
  • 联系人 --列表、获取、创建、删除
  • 联系人列表 --列表、获取、创建、删除、列出成员

认证

获取a 个人访问令牌 从 SurveyMonkey开发者门户:

  1. 登录地址:https://developer.surveymonkey.com/
  2. 首选 我的应用程序 → 创建或打开应用程序
  3. 首选 设置 → 复制您的 访问令牌

令牌通过 SURVEYMONKEY_TOKEN 环境变量。

快速开始

# Run directly (no install)
SURVEYMONKEY_TOKEN=your_token uvx --from git+https://github.com/dscovr/surveymonkey-mcp surveymonkey-mcp

# Or install as a uv tool
uv tool install git+https://github.com/dscovr/surveymonkey-mcp
SURVEYMONKEY_TOKEN=your_token surveymonkey-mcp

克劳德桌面/MCP客户端配置

复制 .mcp.json.example 到 .mcp.json 并填写您的令牌:

{
  "mcpServers": {
    "surveymonkey": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/dscovr/surveymonkey-mcp",
        "surveymonkey-mcp"
      ],
      "env": {
        "SURVEYMONKEY_TOKEN": "YOUR_SURVEYMONKEY_ACCESS_TOKEN"
      }
    }
  }
}

可用工具(共48个)

工具 说明
surveymonkey_get_me 获取当前用户配置文件
surveymonkey_list_surveys 使用筛选器列出调查
surveymonkey_get_survey 获取调查元数据
surveymonkey_get_survey_details 获取包含所有页面和问题的完整调查
surveymonkey_create_survey 创建新调查
surveymonkey_update_survey 替换调查(PUT)
surveymonkey_patch_survey 部分更新调查(PATCH)
surveymonkey_delete_survey 删除调查
surveymonkey_list_pages 调查的列表页面
surveymonkey_get_page 获取页面
surveymonkey_create_page 创建页面
surveymonkey_update_page 更新页面
surveymonkey_delete_page 删除页面
surveymonkey_list_questions 在页面上列出问题
surveymonkey_get_question 问一个问题
surveymonkey_create_question 创建问题
surveymonkey_update_question 更新问题
surveymonkey_delete_question 删除问题
surveymonkey_list_responses 列出响应(仅元数据)
surveymonkey_list_responses_bulk 列出带有答案的回复
surveymonkey_get_response 获得单个响应
surveymonkey_get_response_details 获得包含所有答案的回复
surveymonkey_delete_response 删除响应
surveymonkey_export_responses_csv 将所有响应导出为CSV
surveymonkey_list_collectors 列出调查的收集者
surveymonkey_get_collector 找个收藏家
surveymonkey_create_collector 创建收集器
surveymonkey_update_collector 更新收集器
surveymonkey_delete_collector 删除收集器
surveymonkey_list_collector_messages 列出收件人的电子邮件
surveymonkey_create_collector_message 创建电子邮件
surveymonkey_send_collector_message 发送电子邮件
surveymonkey_list_collector_recipients 列出收集器的收件人
surveymonkey_list_webhooks 列出webhooks
surveymonkey_get_webhook 获取webhook
surveymonkey_create_webhook 创建webhook
surveymonkey_update_webhook 更新webhook
surveymonkey_delete_webhook 删除webhook
surveymonkey_list_contacts 列出联系人
surveymonkey_get_contact 联系我们
surveymonkey_create_contact 创建联系人
surveymonkey_update_contact 更新联系人
surveymonkey_delete_contact 删除联系人
surveymonkey_list_contact_lists 列出联系人列表
surveymonkey_get_contact_list 获取联系人列表
surveymonkey_create_contact_list 创建联系人列表
surveymonkey_delete_contact_list 删除联系人列表
surveymonkey_list_contact_list_members 列出联系人列表的成员

发展

# Install dependencies
uv sync

# Run tests
uv run pytest

# Run the server locally
SURVEYMONKEY_TOKEN=your_token uv run python -m surveymonkey.server