Skip to main content
Glama
data-profiler-mcp

data-profiler-mcp

data-profiler-mcp

CI PyPI PyPI Downloads Python Glama MCP Registry Listed in awesome-mcp-servers License: MIT

An MCP server that lets an LLM understand any tabular data file: point it at a CSV, Parquet, Excel or JSON file and get schema, distributions, data-quality flags and dtype suggestions back as structured JSON.

Stop pasting df.head() and df.info() into chat. Ask your assistant "profile sales.csv" and it reads the file itself, then tells you what is in it, what is wrong with it, and how to load it more efficiently.

data-profiler-mcp demo: one prompt returns severity-ranked data-quality flags and a memory-saving dtype plan

Works with Claude Desktop, Claude Code, Cursor, or any MCP-compatible client.


Features

Seven focused tools, all returning clean JSON:

Tool

What it does

profile_dataset

One-call overview: shape, memory, missing-value summary, duplicate rows, a per-column summary, and plain-language quality flags.

preview_data

The first / last / a random sample of n rows as real records.

column_stats

Deep dive on one column: full percentiles, skew/kurtosis, outliers (IQR), a histogram, or top values + string lengths for text.

detect_quality_issues

A data-quality audit: duplicates, high-missing and constant columns, numbers stored as text, mixed-type columns, whitespace padding, likely IDs, grouped by severity.

suggest_dtypes

Memory-saving / type-fixing recommendations (text to numeric, low-cardinality to category, integer/float downcasting) with estimated savings.

compare_datasets

Diff two files: added/removed columns, dtype changes, row-count delta, and per-column null-rate and mean side by side.

correlation_matrix

Correlations between numeric columns (Pearson / Spearman / Kendall): pairs ranked by strength, multicollinearity flags at |r| >= 0.9, and target-vs-rest ranking via column.

Supported formats: CSV, TSV, Parquet, Excel (.xlsx/.xls), JSON and JSON Lines. Large files are read up to a row cap and clearly flagged as sampled.

No dataset at hand? examples/sample.csv is a small sales export with deliberate quality issues (missing regions, a duplicate row, a constant column, whitespace padding) -- ask your assistant to "profile examples/sample.csv" and see what it flags.


Related MCP server: acb-tax-mcp

Install

No install needed to try it: open the Glama server page and use Try in Browser to call the tools against a sandbox (the repo ships examples/sample.csv at /app/examples/sample.csv to profile).

Requires Python 3.10+.

Requires MCP Python SDK 2.x (mcp>=2,<3). SDK 1.x is feature-frozen upstream and no longer supported here; 0.3.0 is the last release that ran on it.

# with uv (recommended)
uv tool install data-profiler-mcp

# or with pip
pip install data-profiler-mcp

Or run it straight from source without installing:

git clone https://github.com/haiiibin/data-profiler-mcp
cd data-profiler-mcp
uv run data-profiler-mcp

Configure your client

Claude Desktop

Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) and add:

{
  "mcpServers": {
    "data-profiler": {
      "command": "data-profiler-mcp"
    }
  }
}

Running from source instead of installing? Point it at the checkout:

{
  "mcpServers": {
    "data-profiler": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/data-profiler-mcp", "run", "data-profiler-mcp"]
    }
  }
}

Restart Claude Desktop and the tools appear under the plug icon.

Claude Code

claude mcp add data-profiler -- data-profiler-mcp

Usage

Once connected, just talk to your assistant:

  • "Profile ~/data/sales_2025.csv and tell me what's in it."

  • "Are there any data-quality problems in customers.parquet?"

  • "Show me 20 random rows from events.jsonl."

  • "Give me full stats for the revenue column, including outliers."

  • "How can I shrink this DataFrame's memory usage?"

  • "What changed between snapshot_jan.csv and snapshot_feb.csv?"

Example: profile_dataset

{
  "file": { "name": "sample.csv", "format": "csv", "size_human": "14.2 KB" },
  "shape": { "rows": 201, "columns": 13, "sampled": false },
  "memory_usage_human": "78.4 KB",
  "missing_summary": { "total_missing_cells": 561, "pct_missing": 21.5, "columns_with_missing": 3 },
  "duplicate_rows": { "count": 1, "pct": 0.5 },
  "columns": [
    {
      "name": "price", "dtype": "float64", "inferred_type": "float",
      "non_null": 201, "null": 0, "unique": 51,
      "stats": { "min": 0.0, "max": 100000.0, "mean": 521.3, "median": 24.0 }
    }
  ],
  "quality_flags": [
    "[high] empty_col: Column is entirely empty (all values missing).",
    "[warning] const: Column holds a single constant value; it carries no information.",
    "[warning] numeric_text: Every value parses as a number but the column is stored as text."
  ]
}

Example: detect_quality_issues

{
  "issue_count": 8,
  "severity_counts": { "high": 2, "warning": 4, "info": 2 },
  "issues": [
    { "column": "empty_col", "issue": "all_missing", "severity": "high",
      "detail": "Column is entirely empty (all values missing)." },
    { "column": "numeric_text", "issue": "numeric_stored_as_text", "severity": "warning",
      "detail": "Every value parses as a number but the column is stored as text." }
  ]
}

How it works

The server is built on the MCP Python SDK's MCPServer and reads files with pandas (plus pyarrow for Parquet and openpyxl for Excel). Every tool returns a plain, JSON-serializable dict, with NumPy scalars, NaN/inf and timestamps normalized so the output is safe to hand straight back to a model. Nothing is written to disk and no data leaves your machine.


Development

uv venv
uv pip install -e ".[dev]"
uv run pytest

License

MIT. See LICENSE.

Available Tools

7 tools
column_statsA

Deep statistical dive on a single column.

For numeric columns: min/max, mean, std, a full set of percentiles (p1/p5/q1/median/q3/p95/p99), skewness, kurtosis, zero and negative counts, an IQR-based outlier count with bounds, and a 10-bin histogram. For datetime columns: the min and max timestamp. For text/categorical columns: the top values with counts and percentages, plus string-length statistics.

Reach for this after profile_dataset when one column needs closer inspection. Raises an error listing the available columns if column is not found.

Inputs: path (required), column (required), max_rows.

compare_datasetsA

Diff two tabular files: what changed between version A and version B.

Reports the row-count delta, columns added or removed in B, dtype changes on shared columns, and per-column null-rate (and, for numeric columns, mean) for both files side by side.

Use this to compare two snapshots of the same dataset, validate a data pipeline's output against a baseline, or check what a transformation changed.

Inputs: path_a (required), path_b (required), max_rows.

correlation_matrixA

Correlations between numeric columns, ranked by strength.

Computes pairwise correlations across all numeric columns (pearson by default; spearman or kendall for rank-based relationships) and returns pairs ranked by absolute correlation, a high_correlation_pairs list (|r| >= 0.9, a multicollinearity signal when preparing features for modeling), and the full matrix when there are 15 or fewer numeric columns. Pass column to instead rank how strongly every other numeric column correlates with that one, for example a target variable. Constant columns are excluded and listed.

Use this when the user is selecting features for a model, hunting redundant columns, or asking what moves together with a numeric outcome.

Inputs: path (required), column, method, max_rows.

detect_quality_issuesA

Run a focused data-quality audit and return issues grouped by severity.

Detects duplicate rows, all-missing and high-missing columns, constant columns, likely identifier columns, numbers stored as text, dates stored as text, columns mixing numeric and text values, leading/trailing whitespace, and empty (whitespace-only) strings. Each issue carries a column (or null for table-level), an issue code, a severity (high/warning/info), and a plain-language explanation.

Use this when the user cares specifically about cleanliness, is preparing data for modeling, or asks "is anything wrong with this data?".

Inputs: path (required), max_rows.

preview_dataA

Peek at actual rows of a data file.

Returns n rows (capped at 100) as records. mode selects which rows: head (default), tail, or sample (random). Use this to see real example values rather than just statistics, for example to check formatting, encodings, or how a specific column looks in practice.

Inputs: path (required), n, mode.

profile_datasetA

Profile a tabular data file in one call: the fastest way to understand a dataset.

Reads the file at path (CSV, TSV, Parquet, Excel or JSON/JSONL, detected from the extension) and returns a structured overview:

  • file metadata (format, size),

  • shape (row and column counts, and whether the profile was sampled),

  • total memory footprint,

  • a missing-value summary and a duplicate-row count,

  • a per-column summary (dtype, inferred type, null %, unique %, sample values, and basic stats for numeric/datetime columns), and

  • a list of plain-language data-quality flags.

Use this first whenever a user points you at a data file and wants to know what is in it. max_rows caps how many rows are read (default: up to one million); the result flags when the file was larger and the stats are a head sample. Pass 0 to remove the cap entirely.

Inputs: path (required), max_rows.

suggest_dtypesA

Recommend more memory-efficient or more-correct column dtypes.

For each column, proposes a better dtype when one exists: text that is fully numeric to a numeric type, low-cardinality text to category, and oversized integer/float columns downcast to smaller types. Reports per-column and total estimated memory savings.

Use this to help a user shrink a DataFrame's memory footprint or fix columns that were loaded with the wrong type.

Inputs: path (required), max_rows.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 7 tools

    Disambiguation4/5

    Most tools target a clearly different concern: overview profiling, raw row preview, single-column statistics, quality audit, dtype suggestions, dataset comparison, and correlation analysis. There is some overlap between profile_dataset and detect_quality_issues since both surface missing-data and duplicate information, but the descriptions make the intended use cases distinct enough to avoid serious misselection.

    Naming Consistency4/5

    Most names follow a verb_noun pattern: profile_dataset, preview_data, detect_quality_issues, suggest_dtypes, compare_datasets. column_stats and correlation_matrix are noun-based exceptions, but they are still short, descriptive, and readable, so the overall naming is consistent without being rigid.

    Tool Count5/5

    Seven tools is well-scoped for a data profiling server. Each tool covers a meaningful phase of exploration—high-level profiling, previewing rows, deep-diving columns, quality checks, dtype optimization, comparison, and correlation—without redundancy or bloat.

    Completeness5/5

    The tool surface covers the main data-profiling lifecycle: understand overall structure, inspect actual values, drill into a specific column, audit quality issues, suggest type fixes, compare datasets, and analyze correlations. There are no obvious dead ends or critical missing operations for the stated purpose.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      An MCP server that computes Canadian adjusted cost base (ACB) and capital gains from trade history, including average-cost tracking and superficial-loss detection, returning structured JSON.
      7
      71 PyPI
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables data analysis on CSV/Excel files using pandas. Supports profiling, column interpretation, sandboxed code execution, and interactive chart generation.
      4
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server that profiles local data files (CSV, Parquet, JSON, Excel) and returns compact structured summaries with data-quality flags, enabling AI agents to understand datasets without seeing raw rows.
      1
      32 PyPI
      1
      MIT