https://github.com/reading-plus-ai/mcp-server-data-exploration
https://github.com/reading-plus-ai/mcp-server-data-exploration
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/reading-plus-ai/mcp-server-data-exploration
- Owner: reading-plus-ai
- License: mit
- Created: 2024-12-06T18:26:04.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-22T17:26:01.000Z (about 1 year ago)
- Last Synced: 2025-04-02T04:06:01.737Z (about 1 year ago)
- Language: Python
- Size: 43.9 KB
- Stars: 198
- Watchers: 2
- Forks: 23
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp - reading-plus-ai/mcp-server-data-exploration
- awesome-mcp-servers - mcp-server-data-exploration - An MCP server for autonomous data exploration of CSV datasets, delivering AI-driven insights and analysis through the Model Context Protocol. ([Read more](/details/mcp-server-data-exploration.md)) `data-exploration` `csv` `ai-insights` `mcp` (Data Access & Integration MCP Servers)
- awesome-mcp-zh - Data Exploration
- awesome-mcp-servers - Data Exploration - MCP server that enables autonomous exploration of .csv datasets to generate intelligent insights. Note: Executes arbitrary Python code; use with caution. (Community Servers)
- awesome-mcp-servers - @reading-plus-ai/mcp-server-data-exploration - Enables autonomous data exploration on .csv-based datasets, providing intelligent insights with minimal effort. (Legend / 🧮 Data Science Tools)
- awesome-mcp-servers - reading-plus-ai/mcp-server-data-exploration - کاوش داده خودکار را بر روی مجموعه دادههای مبتنی بر csv. امکانپذیر میکند و بینشهای هوشمند را با حداقل تلاش فراهم میکند. (پیادهسازیهای سرور / 🧮 <a name="data-science-tools"></a>ابزارهای علم داده)
- awesome-mcp-servers - Data Exploration - MCP server for autonomous data exploration on .csv-based datasets, providing intelligent insights with minimal effort. (Community Servers)
- awesome-mcp-servers - **mcp-server-data-exploration** - Python-based `python` `http` `csv` `ai` `git` `pip install git+https://github.com/reading-plus-ai/mcp-server-data-exploration` (🤖 AI/ML)
- Awesome-MCP-Servers-directory - Data Exploration - MCP server for autonomous data exploration on .csv-based datasets, providing intelligent insights with minimal effort (Data Science Tools)
- metorial-index - Data Exploration Server - This server facilitates interactive data exploration, converting complex datasets into actionable insights for users. It provides tools for analyzing and visualizing data in a user-friendly manner. (Data Analytics)
- toolsdk-mcp-registry - ❌ data-exploration
- awesome-mcp-security - mcp-server-data-exploration - githubcom-reading-plus-ai-mcp-server-data-exploration) | (カテゴリ / 🧠 <a name="data-science--ml"></a>データサイエンス・ML)
- awesome-mcp-list - @reading-plus-ai/mcp-server-data-exploration - plus-ai/mcp-server-data-exploration?style=social)](https://github.com/reading-plus-ai/mcp-server-data-exploration): Enables autonomous data exploration on `.csv`-based datasets. (Uncategorized / Uncategorized)
- awesome-mcp-servers - Data Explorer Assistant - Generates actionable insights from complex datasets through interactive exploration (Table of Contents / Data Science Tools)
- best-of-mcp-servers - GitHub - 87% open · ⏱️ 22.03.2025) (Data Science Tools)
- awesome-claude-dxt - reading-plus-ai/mcp-server-data-exploration - MCP server for autonomous data exploration on .csv-based datasets, providing intelligent insights with minimal effort. NOTE: Will execute arbitrary Python code on your machine, please use with caution! (🗂️ Extensions by Category / 📊 Analytics)
- awesome-openclaw-skills - Data Exploration - based datasets, providing intelligent insights wi... | - | (MCP Servers & Protocol)
- awesome-mcp - reading-plus-ai/mcp-server-data-exploration - MCP Server for Data Exploration is an interactive tool leveraging the Model Context Protocol to transform complex datasets into actionable insights through CSV loading and Python script execution. (MCP Frameworks and libraries / Python)
README
# MCP Server for Data Exploration
MCP Server is a versatile tool designed for interactive data exploration.
Your personal Data Scientist assistant, turning complex datasets into clear, actionable insights.
## 🚀 Try it Out
1. **Download Claude Desktop**
- Get it [here](https://claude.ai/download)
2. **Install and Set Up**
- On macOS, run the following command in your terminal:
```bash
python setup.py
```
3. **Load Templates and Tools**
- Once the server is running, wait for the prompt template and tools to load in Claude Desktop.
4. **Start Exploring**
- Select the explore-data prompt template from MCP
- Begin your conversation by providing the required inputs:
- `csv_path`: Local path to the CSV file
- `topic`: The topic of exploration (e.g., "Weather patterns in New York" or "Housing prices in California")
## Examples
These are examples of how you can use MCP Server to explore data without any human intervention.
### Case 1: California Real Estate Listing Prices
- Kaggle Dataset: [USA Real Estate Dataset](https://www.kaggle.com/datasets/ahmedshahriarsakib/usa-real-estate-dataset)
- Size: 2,226,382 entries (178.9 MB)
- Topic: Housing price trends in California
[](https://www.youtube.com/watch?v=RQZbeuaH9Ys)
- [Data Exploration Summary](https://claude.site/artifacts/058a1593-7a14-40df-bf09-28b8c4531137)
### Case 2: Weather in London
- Kaggle Dataset: [2M+ Daily Weather History UK](https://www.kaggle.com/datasets/jakewright/2m-daily-weather-history-uk/data)
- Size: 2,836,186 entries (169.3 MB)
- Topic: Weather in London
- Report: [View Report](https://claude.site/artifacts/601ea9c1-a00e-472e-9271-3efafb8edede)
- Graphs:
- [London Temperature Trends](https://claude.site/artifacts/9a25bc1e-d0cf-498a-833c-5179547ee268)
- [Temperature-Humidity Relationship by Season](https://claude.site/artifacts/32a3371c-698d-48e3-b94e-f7e88ce8093d)
- [Wind Direction Pattern by Season](https://claude.site/artifacts/32a3371c-698d-48e3-b94e-f7e88ce8093d)
## 📦 Components
### Prompts
- **explore-data**: Tailored for data exploration tasks
### Tools
1. **load-csv**
- Function: Loads a CSV file into a DataFrame
- Arguments:
- `csv_path` (string, required): Path to the CSV file
- `df_name` (string, optional): Name for the DataFrame. Defaults to df_1, df_2, etc., if not provided
2. **run-script**
- Function: Executes a Python script
- Arguments:
- `script` (string, required): The script to execute
## ⚙️ Modifying the Server
### Claude Desktop Configurations
- macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%/Claude/claude_desktop_config.json`
### Development (Unpublished Servers)
```json
"mcpServers": {
"mcp-server-ds": {
"command": "uv",
"args": [
"--directory",
"/Users/username/src/mcp-server-ds",
"run",
"mcp-server-ds"
]
}
}
```
### Published Servers
```json
"mcpServers": {
"mcp-server-ds": {
"command": "uvx",
"args": [
"mcp-server-ds"
]
}
}
```
## 🛠️ Development
### Building and Publishing
1. **Sync Dependencies**
```bash
uv sync
```
2. **Build Distributions**
```bash
uv build
```
Generates source and wheel distributions in the dist/ directory.
3. **Publish to PyPI**
```bash
uv publish
```
## 🤝 Contributing
Contributions are welcome! Whether you're fixing bugs, adding features, or improving documentation, your help makes this project better.
### Reporting Issues
If you encounter bugs or have suggestions, open an issue in the issues section. Include:
- Steps to reproduce (if applicable)
- Expected vs. actual behavior
- Screenshots or error logs (if relevant)
## 📜 License
This project is licensed under the MIT License.
See the LICENSE file for details.
## 💬 Get in Touch
Questions? Feedback? Open an issue or reach out to the maintainers. Let's make this project awesome together!
## About
This is an open source project run by [ReadingPlus.AI LLC](https://readingplus.ai). and open to contributions from the entire community.