{
  "markdown": "<!-- mcp-name: io.github.oogunbiyi21/stats-compass -->\n\n<div align=\"center\">\n  <img src=\"./assets/logo/logo1.png\" alt=\"Stats Compass Logo\" width=\"200\"/>\n  \n  # stats-compass-mcp\n  \n  **Turn your LLM into a data analyst.** Multiple data science tools via MCP.\n\n  [![PyPI version](https://badge.fury.io/py/stats-compass-mcp.svg)](https://badge.fury.io/py/stats-compass-mcp)\n  [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n</div>\n\n<img src=\"./assets/demos/stats_compass_mcp_1.gif\" alt=\"Demo: Loading and exploring data\" width=\"800\"/>\n\n## Quick Start\n\n```bash\npip install stats-compass-mcp\n```\n\n### Claude Desktop\n\n```bash\nstats-compass-mcp install --client claude\n```\n\n### VS Code (GitHub Copilot)\n\n```bash\nstats-compass-mcp install --client vscode\n```\n\n### Claude Code (CLI)\n\n```bash\nclaude mcp add stats-compass -- uvx stats-compass-mcp run\n```\n\n> **Note:** The first connection may fail while `uvx` downloads the package. If this happens, disable and re-enable Stats Compass in your MCP settings — subsequent connections will be instant.\n\nRestart your client and start asking questions about your data.\n\n## What Can It Do?\n\n<img src=\"./assets/demos/stats_compass_mcp_2.gif\" alt=\"Demo: Cleaning and transforming data\" width=\"800\"/>\n\n| Category | Examples |\n|----------|----------|\n| **Data Loading** | Load CSV/Excel, sample datasets, list DataFrames |\n| **Cleaning** | Drop nulls, impute, dedupe, handle outliers |\n| **Transforms** | Filter, groupby, pivot, encode, add columns |\n| **EDA** | Describe, correlations, hypothesis tests, data quality |\n| **Visualization** | Histograms, scatter, bar, ROC curves, confusion matrix |\n| **ML Workflows** | Classification, regression, time series forecasting |\n\nRun `stats-compass-mcp list-tools` to see all available tools.\n\n## How to Prompt\n\nStart your message with **\"Use stats compass to...\"** — this tells the AI to use the Stats Compass tools instead of trying to write code or use other methods.\n\n```\nUse stats compass to load ~/Downloads/sales.csv and run EDA on it\nUse stats compass to find my CSV files in Downloads\nUse stats compass to clean the dataset and handle missing values\nUse stats compass to create a histogram of the price column\nUse stats compass to test if there's a significant difference in scores between group A and B\nUse stats compass to train a classification model to predict churn\n```\n\n> **Tip:** Without this prefix, some AI clients may try to write Python code or use shell commands instead of the Stats Compass tools — especially for tasks like finding files on your machine.\n\n## Loading Files\n\n**Local mode:** Start with \"Use stats compass to load...\" and provide the file path or folder.\n\n```\nUse stats compass to load the CSV at ~/Downloads/sales.csv\nUse stats compass to find my data files in ~/Documents\n```\n\n**Remote/HTTP mode:** Use the upload feature (see below).\n\n## Remote Server Mode\n\nFor Docker deployments or multi-client setups:\n\n```bash\nstats-compass-mcp serve --port 8000\n```\n\n### File Uploads\n\nWhen running remotely, users can upload files via browser:\n\n<img src=\"./assets/demos/upload_screenshot.png\" alt=\"File Upload Interface\" width=\"500\"/>\n\n```\nYou: I want to upload a file\nAI: Open this link to upload: http://localhost:8000/upload?session_id=abc123\n\n[Upload in browser]\n\nYou: I uploaded sales.csv\nAI: ✅ Loaded sales.csv (1,000 rows × 8 columns)\n```\n\n### Downloading Results\n\nExport DataFrames, plots, and trained models:\n\n```\nYou: Save the cleaned data as a CSV\nAI: ✅ Saved. Download: http://localhost:8000/exports/.../cleaned_data.csv\n```\n\n### Connect Clients to Remote Server\n\n**VS Code** (native HTTP support):\n```json\n{\n  \"servers\": {\n    \"stats-compass\": { \"url\": \"http://localhost:8000/mcp\" }\n  }\n}\n```\n\n**Claude Desktop** (via [mcp-proxy](https://github.com/sparfenyuk/mcp-proxy)):\n```json\n{\n  \"mcpServers\": {\n    \"stats-compass\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-proxy\", \"--transport\", \"streamablehttp\", \"http://localhost:8000/mcp\"]\n    }\n  }\n}\n```\n\n## Docker\n\n```bash\ndocker run -p 8000:8000 -e STATS_COMPASS_SERVER_URL=https://your-domain.com stats-compass-mcp\n```\n\n## Client Compatibility\n\n| Client | Status |\n|--------|--------|\n| Claude Desktop | ✅ Recommended |\n| VS Code Copilot | ✅ Supported |\n| Claude Code CLI | ✅ Supported |\n| Cursor | ✅ Supported |\n| GPT / Gemini | ⚠️ Partial |\n\n## Configuration\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `STATS_COMPASS_PORT` | `8000` | Server port |\n| `STATS_COMPASS_SERVER_URL` | `http://localhost:8000` | Base URL for upload/download links |\n| `STATS_COMPASS_MAX_UPLOAD_MB` | `50` | Max upload size |\n\n## Development\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup.\n\n## 🙏 Credits\n\nLanding page template by **ArtleSa** (u/ArtleSa)\n\n## License\n\nMIT\n",
  "bytes": 4935,
  "sha": "bf67488f987e005281566aa33de9fa1b0d2104ce37a92447d447c01d5be5ca05",
  "repo_slug": "oogunbiyi21/stats-compass-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_oogunbiyi21_stats_compass_75a964e9/readme"
}