Windsurf 的 agent 规划、写码、运行——它产出的每个东西都躺在工作区里。递给它一个 FormLM 接口,产出就变成你能查询的数据,而不是你划过去就忘的文件。
Windsurf 的节奏是一个快循环:描述工具,Cascade 搭出来、跑起来、把输出给你看。价格爬虫把结果打印到终端。数据清洗流程往工作区写一个 CSV。内部仪表盘对着示例数据渲染一次。每个结果都是真的——也都是搁浅的:下个会话看不见它,同事的 Windsurf 看不见它,跑多少次也攒不起来。
一个共享存储接口正合这个节奏。每次运行把结果 POST 到同一个 FormLM URL;谁要看,查询 API 随时全读回来。没有数据库要开、没有 schema 要设计——首次提交就把字段定了。而且接口在 ?help 自带文档,Cascade 执行到一半自己就能发现格式。
把接口放进任务里。末尾带上 ?help,贴进 Cascade 对话。它返回一份 Markdown 文档,列全每个字段、方法与示例——Cascade 读完第一次就把 POST 调用写对:
"把我列的那些定价页爬一遍,把每条结果 记到这个 API: https://formlm.me/api/v3/share/YOUR_TOKEN?help 先读文档,每个页面提交一条记录。" # Cascade 读取 schema、对上字段、 # 存下每次爬取——结构化、可查询。
把 formlm-cli 注册为 MCP 服务器,Cascade 就能全程对话干完整件事:建表单、定义字段、发布接口、查询结果。先装 CLI(npm install -g @formlm/cli),再改 Windsurf 的配置——注意路径在 .codeium 底下,改完完全重启编辑器:
{
"mcpServers": {
"formlm": {
"command": "formlm-cli",
"args": ["mcp"],
"env": {
"PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
}
}
}
}
macOS 上 env.PATH 这行帮你省掉经典的 command not found——Windsurf 启动 MCP 服务器不带终端 PATH,Homebrew 装的程序得写明白。跑一次 formlm-cli auth login --token <your-token>(令牌从 formlm.me → 账号设置复制)登录,token 长期有效。完整 CLI 参考在开发者专区。
$ curl -X POST https://formlm.me/api/v3/share/YOUR_TOKEN \ -H "Content-Type: application/json" \ -d '{ "data": { "vendor": "acme-cloud", "plan": "pro-monthly", "price_usd": 49, "scraped_at": "2026-09-30" }, "meta": {"source": "windsurf-cascade"} }' # 读取——下个会话带着完整历史开跑 $ curl https://formlm.me/api/v3/share/YOUR_TOKEN/query?page=1&size=50
Cascade 构建的页面从浏览器就能用同一个接口——CORS 双向全开——每条记录在 FormLM 界面里看得见、能导出 CSV。历史属于你的工作流,不属于 Windsurf 的工作区。
在 ~/.codeium/windsurf/mcp_config.json——注意是 .codeium 目录,不是 .windsurf。文件用标准 JSON mcpServers 格式,跟 Claude Desktop、Cursor 长一个样。保存后完全重启 Windsurf;MCP 服务器只在启动时加载。
能。把带 ?help 的接口 URL 贴进 Cascade 对话。接口返回一份 Markdown 文档,列出字段、方法与示例——Cascade 读完,在它构建的代码里写出正确的 POST 调用,不需要任何 MCP 配置。
能。接口读写都发 CORS 头,跑在 localhost、Windsurf 预览服务器或任何静态托管上的页面都能直接 POST。本地文件打开的页面也行——file:// 页面是明确支持的。
从 formlm.me → 账号设置复制访问令牌,终端里跑一次 formlm-cli auth login --token <your-token>——存下的 token 之后 MCP 服务器会自动读取。验证码和 Google 注册的账号没有密码——用访问令牌,或在终端跑 formlm-cli auth login 选「邮箱验证码」直接登录。或者给无界面机器设 FORMLM_TOKEN 环境变量。