surveyloop

surveyloop

surveyloop 是一个连接托管 Inquira MCP 服务的小型本地桥接程序，该服务可端到端运行 AI 调研。 描述研究目标后，它会生成一份专业调研问卷；之后，你可以发布问卷、分享链接、查看收到的回答，并请求生成 AI 分析报告，其中包含执行摘要、关键指标、逐题洞察和行动建议。

该桥接程序不保存任何问卷数据。它会在本地提供上游服务的工具列表，该列表与从实时端点捕获的内容完全一致；它会将每次工具调用转发到上游，并原样返回结果。捕获的功能范围仅限于返回问卷自身的分享链接：将该链接发送给任何人属于调用方自己的行为，且其中没有联络或发送工具。

工具

• create_survey — 根据研究目标生成问卷。必填：goal。可选：lang（取值为 "en"、"zh"、"ja"、"es"、"pt" 之一；默认为 "en"）和 publish（创建后立即发布；默认为 false）。返回问卷 ID 和可分享链接。
• get_surveys — 列出经过身份验证的用户拥有的所有问卷。可选：status（取值为 "all"、"published"、"draft" 之一；默认为 "all"）。
• get_responses — 获取提交到指定问卷的所有回答。必填：survey_id。
• get_ai_report — 根据问卷回答生成 AI 分析报告。必填：survey_id。
• publish_survey — 发布问卷，使其可通过分享链接访问。必填：survey_id。
• get_survey_link — 获取已发布问卷的可分享链接。必填：survey_id。

配置

• INQUIRA_MCP_URL（可选）— 覆盖上游端点。默认为 https://getinquira.com/api/mcp。（此覆盖钩子是本次重建中自行标注的还原内容。）
• INQUIRA_API_KEY（可选）— 设置后，每个上游请求都会携带 Authorization: Bearer <key> 标头，使用调用方自己的 Inquira 密钥。未设置时，不会发送密钥标头。（标头名称由原始注册记录确定；Bearer 方案和此环境变量转发方式是标注的还原内容——原始功能表面是在不带密钥的情况下捕获的。）

转发机制

首次调用工具时，客户端会与上游建立可流式传输的 HTTP 会话：先发送 JSON-RPC initialize 请求（protocolVersion 2025-03-26，clientInfo name surveyloop），再发送 notifications/initialized 通知，最后发送携带调用方原样参数的 tools/call 请求。当上游在 initialize 响应中返回 Mcp-Session-Id 标头时，该值会随会话的每个后续请求一起发送；此会话会在进程运行期间重复使用。响应既可能是普通 JSON，也可能是服务器发送事件；两种格式都会读取。

成功的上游结果会原样传递，包括上游设置的任何 isError 标志。 失败情况——JSON-RPC 错误、非 2xx 状态、无法读取响应或无法完成请求——会作为 isError 结果返回，其文本以 surveyloop error: 开头（此错误呈现方式是本次重建中自行标注的还原内容）。

CLI

每个工具也可作为子命令使用，并接收一个 JSON 参数字符串：

npx @reneturcios/surveyloop create_survey '{"goal":"Customer satisfaction survey for our SaaS product after onboarding","lang":"en"}'
npx @reneturcios/surveyloop get_responses '{"survey_id":"sv_123"}'
npx @reneturcios/surveyloop --version

退出代码：成功时为 0，结果为 isError 时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/surveyloop mcp

MCP 客户端配置：

{
  "mcpServers": {
    "surveyloop": {
      "command": "npx",
      "args": ["-y", "@reneturcios/surveyloop", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/surveyloop
docker run --rm ghcr.io/cloudcorprecords/surveyloop --version

容器的默认命令是 mcp，因此第一种形式是 stdio MCP 服务；其他参数则会正常传递给 CLI。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全通过桩接的 JSON-RPC 上游运行，不会进行实时网络调用。

许可证

MIT — 参见 LICENSE。