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（CLI）

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

注： 初回の接続では、uvx がパッケージをダウンロードしている間に失敗することがあります。その場合は、MCP の設定で Stats Compass を無効にしてから再度有効にしてください。以降の接続はすぐに完了します。

クライアントを再起動して、データについて質問してみましょう。

何ができますか？

カテゴリ	例
データの読み込み	CSV／Excel、サンプルデータセットの読み込み、DataFrame の一覧表示
クリーニング	null 値の削除、補完、重複の削除、外れ値の処理
変換	フィルタリング、groupby、ピボット、エンコード、列の追加
探索的データ分析（EDA）	要約統計量、相関、仮説検定、データ品質
可視化	ヒストグラム、散布図、棒グラフ、ROC 曲線、混同行列
ML ワークフロー	分類、回帰、時系列予測

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 クライアントは Stats Compass のツールではなく、Python コードを書いたりシェルコマンドを使ったりすることがあります。特に、マシン上のファイルを探すようなタスクで起こりやすくなります。

ファイルの読み込み

ローカルモード： 「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 文字以上のベアラートークンを設定し、パブリックアドレスにバインドしてください。

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