Stats Compass MCP

🚀 stats-compass-mcp

將你的大語言模型轉變為數據分析師。通過MCP提供多種數據科學工具。

項目徽章

🚀 快速開始

你可以使用以下命令安裝stats-compass-mcp：

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 (CLI)

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

安裝完成後，重啟客戶端，就可以開始詢問有關數據的問題了。

✨ 主要特性

你可以運行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

文件上傳

在遠程運行時，用戶可以通過瀏覽器上傳文件：

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)

下載結果

可以導出數據框、繪圖和訓練好的模型：

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

📚 詳細文檔

客戶端兼容性

配置參數

開發

有關開發設置，請參閱 CONTRIBUTING.md。

🙏 致謝

本項目的著陸頁模板由 ArtleSa (u/ArtleSa) 提供。

📄 許可證

本項目採用MIT許可證。