data-profiler-mcp
This MCP server lets an LLM inspect and analyze tabular data files (CSV, TSV, Parquet, Excel, JSON/JSONL) and return structured JSON insights.
Profile a dataset – get shape, memory usage, missing values, duplicates, per-column summaries, and quality flags in one call.
Preview rows – view the first, last, or random sample of actual records.
Deep-dive on a column – full statistics: percentiles, skew/kurtosis, outliers, histograms, top values, string lengths.
Audit data quality – detect duplicates, missing/constant columns, numbers stored as text, mixed types, whitespace issues, and more, grouped by severity.
Suggest better dtypes – get memory-saving type recommendations (e.g., downcasting, category, numeric conversion) with estimated savings.
Compare two datasets – diff schemas, row counts, dtype changes, null rates, and numeric means side by side.
Compute correlation matrices – Pearson/Spearman/Kendall correlations between numeric columns, ranked pairs, multicollinearity flags, or target-vs-rest ranking.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@data-profiler-mcp Profile sales_2025.csv and tell me what's in it."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
data-profiler-mcp
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.

Works with Claude Desktop, Claude Code, Cursor, or any MCP-compatible client.
Features
Seven focused tools, all returning clean JSON:
Tool | What it does |
| One-call overview: shape, memory, missing-value summary, duplicate rows, a per-column summary, and plain-language quality flags. |
| The first / last / a random sample of |
| Deep dive on one column: full percentiles, skew/kurtosis, outliers (IQR), a histogram, or top values + string lengths for text. |
| A data-quality audit: duplicates, high-missing and constant columns, numbers stored as text, mixed-type columns, whitespace padding, likely IDs, grouped by severity. |
| Memory-saving / type-fixing recommendations (text to numeric, low-cardinality to |
| Diff two files: added/removed columns, dtype changes, row-count delta, and per-column null-rate and mean side by side. |
| Correlations between numeric columns (Pearson / Spearman / Kendall): pairs ranked by strength, multicollinearity flags at |r| >= 0.9, and target-vs-rest ranking via |
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-mcpOr run it straight from source without installing:
git clone https://github.com/haiiibin/data-profiler-mcp
cd data-profiler-mcp
uv run data-profiler-mcpConfigure 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-mcpUsage
Once connected, just talk to your assistant:
"Profile
~/data/sales_2025.csvand 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
revenuecolumn, including outliers.""How can I shrink this DataFrame's memory usage?"
"What changed between
snapshot_jan.csvandsnapshot_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 pytestLicense
MIT. See LICENSE.
Available Tools
7 toolscolumn_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
Scored across 7 tools
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.
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.
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.
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
Related MCP Connectors
Messy CSV, JSON, Excel, SPSS/Stata/SAS and PDF tables to typed Parquet; inspect, query, join.
Every spreadsheet is a table: Excel, CSV, Parquet and JSON as SQL tables for AI agents.
Profile, clean and validate CSV/Excel data: schemas, dates, numbers, duplicates. Never guesses.
File tools for your AI chat: PDF tables to Excel, merge PDFs, images to PDF, fill PDF forms.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables conversational analysis of CSV and Parquet files through natural language, providing statistics, summaries, data type information, and comprehensive multi-step data analysis.-
- AlicenseAqualityCmaintenanceAn 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.771 PyPIMIT
- AlicenseAqualityCmaintenanceEnables data analysis on CSV/Excel files using pandas. Supports profiling, column interpretation, sandboxed code execution, and interactive chart generation.41MIT
- AlicenseAqualityCmaintenanceMCP 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.132 PyPI1MIT