MCP Analyst
by unravel-team
README.md
# MCP Analyst
MCP Analyst is an MCP server that empowers claude to analyze local CSV or Parquet files.
Use this server when your dataset size is bigger than the context window or you don't want to upload full file to optimize the cost.
# Installation
## Install uv
[uv](https://docs.astral.sh/uv/) is required to run the MCP server.
**Mac**
```
brew install uv
```
**Windows**
```
winget install --id=astral-sh.uv -e
```
## Add servers in MCP
To use the server in Claude you would need to update the Claude config
On MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json` On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
```
{
"mcpServers": {
"analyst": {
"command": "uvx",
"args": [
"mcp-analyst",
"--file_location",
"<replace_this_with_path_to_csv_or_parquet_files_on_your_machine>"
]
}
}
}
```
# How do I provide more than one CSV file?
The server supports the using globs in the file location. So for example if your directory `data` has more than one csv file then you can give file-location as `<parent_path_to_data>/data/*.csv`
TDQS
A3.5/5.0
Scored across 3 tools
Disambiguation5/5
Each tool has a distinct purpose: listing files, inspecting schema, and executing SQL queries. No overlap or ambiguity.
Naming Consistency4/5
All names use snake_case with a verb_noun pattern. Two tools start with 'get_', while 'execute_polars_sql' uses 'execute_', which is a slight inconsistency but still predictable.
Tool Count4/5
3 tools is slightly low but appropriate for a focused analysis server covering file discovery, schema inspection, and query execution. Not overly sparse.
Completeness4/5
The set covers the basic workflow of listing data sources, examining schema, and running SQL queries. Missing possibly result writing or data transformation, but core functionality is present.
Maintenance
ActivityInactive
ResponsivenessNo issues