Stats Compass

快速入门

pip install stats-compass-mcp

Claude Desktop

stats-compass-mcp install --client claude

VS Code（GitHub Copilot）

stats-compass-mcp install --client vscode

Claude Code（命令行）

claude mcp add stats-compass -- uvx stats-compass-mcp run

注意： 首次连接时，uvx 可能仍在下载软件包，导致连接失败。如果发生这种情况，请在 MCP 设置中停用再重新启用 Stats Compass；之后的连接会立即完成。

重启客户端，然后开始询问有关数据的问题。

它能做什么？

类别	示例
数据加载	加载 CSV/Excel、示例数据集、列出 DataFrame
清理	删除空值、填补缺失值、去重、处理异常值
转换	筛选、分组、透视、编码、添加列
探索性数据分析	描述、相关性、假设检验、数据质量
可视化	直方图、散点图、条形图、ROC 曲线、混淆矩阵
机器学习工作流	分类、回归、时间序列预测

运行 stats-compass-mcp list-tools 查看所有可用工具。

如何编写提示词

在消息开头使用 “Use stats compass to...”——这会告诉 AI 使用 Stats Compass 工具，而不是尝试编写代码或使用其他方法。

Use stats compass to load ~/Downloads/sales.csv and run EDA on it
Use stats compass to find my CSV files in Downloads
Use stats compass to clean the dataset and handle missing values
Use stats compass to create a histogram of the price column
Use stats compass to test if there's a significant difference in scores between group A and B
Use stats compass to train a classification model to predict churn

提示： 如果没有此前缀，一些 AI 客户端可能会尝试编写 Python 代码或使用 shell 命令，而不是使用 Stats Compass 工具；尤其是在查找计算机上的文件等任务中。

加载文件

本地模式： 以“Use stats compass to load...”开头，并提供文件或文件夹路径。

Use stats compass to load the CSV at ~/Downloads/sales.csv
Use stats compass to find my data files in ~/Documents

远程/HTTP 模式： 使用上传功能（见下文）。

远程服务模式

适用于 Docker 部署或多客户端设置：

stats-compass-mcp serve --port 8000

serve 默认绑定到 127.0.0.1。若要接受来自其他计算机的连接， 请设置至少 16 个字符的 bearer 令牌，并绑定到一个公共地址：

export STATS_COMPASS_AUTH_TOKEN="$(openssl rand -hex 24)"
export STATS_COMPASS_SECRET_KEY="$(openssl rand -hex 32)"   # encrypts upload/download links
stats-compass-mcp serve --host 0.0.0.0 --port 8000

客户端发送 Authorization: Bearer <token>。未设置令牌时，服务会拒绝绑定到公共地址；对于你信任的网络，可使用 --no-auth 覆盖此限制，但会显示警告。每个会话只能读取自己的上传文件，也只能写入自己的导出文件。上传和下载链接包含会过期的加密令牌（下载链接在 24 小时后过期，STATS_COMPASS_DOWNLOAD_TTL_SECONDS），绝不包含会话 ID。

闲置 24 小时的会话将被移除，其数据、模型和导出文件也会一并删除（STATS_COMPASS_SESSION_IDLE_HOURS；设置为 0 可禁用此功能）。正在执行工具调用的会话绝不会被移除。嵌入这些工具的服务会使用自己的清理程序 SessionManager.evict_idle(max_idle)。

文件上传

在远程运行时，用户可以通过浏览器上传文件：

You: I want to upload a file
AI: Open this link to upload: http://localhost:8000/upload?session_id=abc123

[Upload in browser]

You: I uploaded sales.csv
AI: ✅ Loaded sales.csv (1,000 rows × 8 columns)

下载结果

导出 DataFrame、图表和训练好的模型：

You: Save the cleaned data as a CSV
AI: ✅ Saved. Download: http://localhost:8000/exports/.../cleaned_data.csv

将客户端连接到远程服务

VS Code（原生 HTTP 支持）：

{
  "servers": {
    "stats-compass": { "url": "http://localhost:8000/mcp" }
  }
}

Claude Desktop（通过 mcp-proxy）：

{
  "mcpServers": {
    "stats-compass": {
      "command": "uvx",
      "args": ["mcp-proxy", "--transport", "streamablehttp", "http://localhost:8000/mcp"]
    }
  }
}

Docker

docker run -p 8000:8000 -e STATS_COMPASS_SERVER_URL=https://your-domain.com stats-compass-mcp

客户端兼容性

客户端	状态
Claude Desktop	✅ 推荐
VS Code Copilot	✅ 支持
Claude Code CLI	✅ 支持
Cursor	✅ 支持
GPT / Gemini	⚠️ 部分支持

配置

变量	默认值	描述
STATS_COMPASS_PORT	8000	服务端口
STATS_COMPASS_SERVER_URL	http://localhost:8000	上传／下载链接的基础 URL
STATS_COMPASS_MAX_UPLOAD_MB	50	最大上传大小

开发

开发环境设置请参阅 CONTRIBUTING.md。

🙏 致谢

落地页模板由 ArtleSa（u/ArtleSa）提供

许可证

MIT