在 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 创建项目,按地区做主要结果的交叉表,并说明样本基数、警告和下一步。
如何安装本地 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 上传原始文件或项目。
已经验证的能力
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 生成与刷新、项目导出和审计历史。
- 数值结论必须显示样本基数、假设、警告和非因果解释。
对等范围与远程边界
浏览器 Worker 与本地 headless MCP 进入同一个 HeadlessCrosstabsService,并复用 TabBookProject、初始分析、确定性计算、revision、audit、replay 与 undo 编排。浏览器交互状态和本地文件授权仍是独立表面;公开 parity.json 只声明当前已验证的本地边界。
www.crosstabs.com/api/headless-mcp 是只用于方法查询的远程端点:解释统计方法并计算小型频数表,不接受调查文件或受访者数据,也不保存任何内容。
适合的使用方式
插件适合让 Codex 直接完成一个可审计的调查项目,也适合复核单张列联表。机密文件可使用浏览器或本地 crosstabs-headless,文件不会离开设备。AI 客户端及其供应商的数据政策另行适用。
统计显著不等于实际重要,更不等于因果。高风险结论仍应由合格统计人员复核;Crosstabs 当前公开披露具名独立统计审查证据尚待完成。