跳至内容
打开导航
打开分析工作区

面向 AI 助手的调查分析工具

Crosstabs 免费调查分析 MCP

需要 Node.js 22 及以上版本和 uv(uv 会自带 Python 3.12)。运行 uv tool install --python 3.12 crosstabs==1.5.3(或 uvx crosstabs),再用 uv tool dir --bin 显示的完整路径,把 crosstabs-headless 与 crosstabs 添加为本地 stdio MCP 服务器。无需 Crosstabs 账户或 API 密钥;调查文件与项目留在你的设备上。不想安装时,可直接使用浏览器工作区。

当前产品边界

PyPI 1.5.3 与插件分发边界

浏览器 Worker 与本地 MCP 进入同一个 HeadlessCrosstabsService,并共享 TabBookProject、初始分析、确定性计算、项目修订、审计、重放与撤销编排。

查看本地 MCP 安装步骤
01

在 Claude Desktop 中配置本地 MCP

在 claude_desktop_config.json(设置 → 开发者 → 编辑配置)的 mcpServers 中,用完整路径添加 crosstabs-headless 与 crosstabs 两个命令(AI 应用通常看不到终端的 PATH);Claude Code 可运行 claude mcp add crosstabs-headless --scope user -e CROSSTABS_MCP_ALLOWED_ROOTS="$HOME/Surveys" -- "$(uv tool dir --bin)/crosstabs-headless"。其他支持 stdio 的 MCP 客户端配置方式相同。

项目服务器只读写你允许的文件夹:在 crosstabs-headless 的 env 中把 CROSSTABS_MCP_ALLOWED_ROOTS 设为调查文件所在的文件夹(多个文件夹在 macOS/Linux 用 : 分隔,Windows 用 ; 分隔),或把文件复制到私有交换文件夹(macOS:~/Library/Application Support/Crosstabs/headless/exchange),然后重启客户端。其他文件夹(包括“下载”和“桌面”)不会被读取。

然后让 AI 调用 get_runtime_status,并给出允许文件夹内调查文件的完整路径,例如:用 Crosstabs 为 /Users/you/Surveys/survey.csv 创建项目,按地区做主要结果的交叉表,并说明样本基数、警告和下一步。

02

如何安装本地 MCP 包

运行 uv tool install --python 3.12 crosstabs==1.5.3(uv 会自带 Python 3.12;也可用 pipx install crosstabs==1.5.3,需 Python 3.10+),再用 uv tool dir --bin 显示的完整路径,将 crosstabs-headless 与 crosstabs 两个 stdio 命令添加到本地 MCP 客户端。也可使用 uvx --from crosstabs==1.5.3 启动相应命令。插件安装应使用英文 MCP 页面中已验证的准确源码 SHA,不要用 main 分支代替不可变引用。

两个本地服务器的全新公开索引安装已验证。插件尚未提交到任何插件目录,也未在目录中上架。本地 MCP 无需向 Crosstabs.com 上传原始文件或项目。

03

已经验证的能力

PyPI 1.5.3 的发布记录、构件清单、可信发布者证明以及官方 MCP Registry 的准确 1.5.3 活跃记录均已验证;全新安装启动了两个 stdio 服务器:统计服务器返回 39 个分析工具、6 个市场研究工具、数据库与调查平台拉取工具及一个运行状态工具(共 48 个),项目服务器返回精确的 37 个项目工具。

分析技能要求先说明分析单位、缺失值规则、变量方向、权重含义和多选题结构,再检查统计假设、选择检验、报告效应量,并区分精确、渐近与模拟推断。

  • 列联表检验、效应量、序数关联、一致性与流行病学 2×2 指标。
  • 期望频数、残差、事后分解、Bonferroni 与 FDR 等诊断。
  • 版本化方法限制与公开证据链接。
  • get_runtime_status 确认实际运行版本;分析计划可创建、验证和运行,记录可读设置并拒绝过期或超出资源限制的计划。
  • 项目创建、CSV/Excel/SPSS/Stata/SAS/JSON 导入、Row Set、Multibanner、筛选、权重、Tab Book 和波次比较。
  • 浏览器工作区提供本地开放题代码本与人工审核;本地 MCP 提供 Schema 漂移修复、可编辑 PPTX/DOCX 生成与刷新、项目导出和审计历史。
  • 数值结论必须显示样本基数、假设、警告和非因果解释。
04

对等范围与远程边界

浏览器 Worker 与本地 headless MCP 进入同一个 HeadlessCrosstabsService,并复用 TabBookProject、初始分析、确定性计算、revision、audit、replay 与 undo 编排。浏览器交互状态和本地文件授权仍是独立表面;公开 parity.json 只声明当前已验证的本地边界。

www.crosstabs.com/api/headless-mcp 是只用于方法查询的远程端点:解释统计方法并计算小型频数表,不接受调查文件或受访者数据,也不保存任何内容。

05

适合的使用方式

插件适合让 Codex 直接完成一个可审计的调查项目,也适合复核单张列联表。机密文件可使用浏览器或本地 crosstabs-headless,文件不会离开设备。AI 客户端及其供应商的数据政策另行适用。

统计显著不等于实际重要,更不等于因果。高风险结论仍应由合格统计人员复核;Crosstabs 当前公开披露具名独立统计审查证据尚待完成。

常见问题

先确认方法,再解释结果。

Codex 插件和 PyPI MCP 包有什么区别?

PyPI 1.5.3 包提供 37 个项目工具,统计服务器提供 39 个分析工具、6 个市场研究工具、数据库与调查平台拉取工具、一个运行状态工具和证据资源。公开源码插件 0.4.0 仍固定 1.4.0 包版本(35 个项目工具),配置两个本地服务器,并加入调查分析技能、默认提示、图标和机器可读的对等边界;需要 1.5.0 新增工具时请直接安装 PyPI 包。插件以源码方式安装,尚未申请目录批准,也未在任何插件目录上架。

插件是否会把原始数据发送到 Crosstabs.com?

本地 MCP 统计进程通过 stdio 运行,不需要把数据发送到 Crosstabs.com。发送给 Codex 或其他 AI 助手的内容仍受该助手的数据处理政策与用户配置约束。

插件是否支持权重、Multibanner 和显著性字母?

插件固定的 1.4.0 可保存 Row Set、Multibanner、筛选与权重候选;未声明含义的权重会被拒绝执行,受支持且已保存的调查设计采用设计型推断。权重与多选题基数保留在结果中。

插件可以自动生成并刷新 PPTX 或 DOCX 吗?

支持。generate_report_pack 可生成可编辑 PPTX 或 DOCX;refresh_report_pack 通过稳定锚点刷新生成区域,并在兼容内容中保留人工编辑,所有输出与变更都进入项目审计历史。

在完整数据上运行同样的分析。

源文件在浏览器本地处理,无需注册。基础交叉分析支持中文;部分专业功能和文档导出说明仍为英文。

打开工作区