Formswrite

Formswrite MCP

将 Claude Desktop、Cursor、Claude Code 和其他 MCP 客户端连接到 Formswrite API。

将文档转换为 Google Forms，编辑问题，列出并发布表单，以及运行 AI 表单助手工具——全部通过你的大模型完成。

你可以做什么

安装后，你的大模型即可使用 Formswrite 工具集：

• create_form — 根据 Google Doc、PDF 或粘贴的文本创建 Formswrite 任务
• get_form_data — 读取表单当前的问题、选项和元数据
• modify_questions — 添加、编辑、删除或重新排序问题
• update_form_metadata — 更新标题、说明或简介
• publish_form — 发布草稿表单，使其可以接收回复
• export_form — 将表单导出为 Google Forms、Moodle、Kahoot、Quizizz、Canvas 和其他 25 种以上格式
• list_jobs / get_job — 浏览并查看你的转换任务

安装

1. 获取 API 令牌

登录 Formswrite 控制面板，并在此处创建 API 令牌： https://app.formswrite.com/settings/api-tokens

2. 添加到 MCP 客户端

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "formswrite": {
      "command": "npx",
      "args": ["-y", "@formswrite/mcp"],
      "env": {
        "FORMSWRITE_API_TOKEN": "fw_..."
      }
    }
  }
}

重启 Claude Desktop。Formswrite 工具将显示在工具列表中。

Cursor

在 Settings → MCP 中添加：

{
  "formswrite": {
    "command": "npx",
    "args": ["-y", "@formswrite/mcp"],
    "env": { "FORMSWRITE_API_TOKEN": "fw_..." }
  }
}

Claude Code

claude mcp add formswrite -- npx -y @formswrite/mcp

然后在 ~/.claude/settings.json 中设置令牌：

{ "env": { "FORMSWRITE_API_TOKEN": "fw_..." } }

直接使用 Streamable HTTP（无需 npm）

如果你的客户端原生支持 Streamable HTTP 传输（Cursor 0.45+、ChatGPT MCP、近期版本的 Claude Desktop），可以跳过此软件包，直接连接：

URL:    https://mcp.formswrite.com/mcp
Header: Authorization: Bearer fw_...

工作原理

此软件包是一个小型 stdio ↔ Streamable HTTP 桥接程序。它在你的计算机上本地运行，使用 API 令牌连接到 https://mcp.formswrite.com/mcp，并在 MCP 客户端（stdio）与 Formswrite 服务（HTTP）之间转发 JSON-RPC 消息。

所有工具逻辑都在 Formswrite 后端运行——此软件包不包含业务逻辑，除转发数据外也不会接触你的表单数据。

配置

环境变量	必需	默认值	说明
FORMSWRITE_API_TOKEN	是	—	Formswrite 控制面板中的 API 令牌
FORMSWRITE_MCP_URL	否	https://mcp.formswrite.com/mcp	用于暂存环境或可自托管部署的覆盖值

故障排除

诊断输出会写入 stderr（stdout 是 JSON-RPC 通道）。查看日志的方法：

• Claude Desktop：打开 MCP 日志面板（Settings → Developer）
• 命令行：运行 FORMSWRITE_API_TOKEN=... npx @formswrite/mcp 2>&1 >/dev/null

常见问题：

• Missing token — 客户端 MCP env 块中未设置 FORMSWRITE_API_TOKEN
• 401 unauthorized — 令牌无效、已过期，或属于错误的环境。在上方的控制面板 URL 中生成新令牌
• 429 rate_limited — 已超过每分钟 60 个请求的限制；请降低请求频率

许可证

MIT — 参见 LICENSE。

链接

• Formswrite：https://formswrite.com
• 控制面板：https://app.formswrite.com
• 问题反馈：https://github.com/formswrite/formswrite-mcp/issues
• MCP 规范：https://modelcontextprotocol.io