MCP Data Analyst

Un servidor ligero del Model Context Protocol (MCP) construido con Python y Pandas que expone capacidades reutilizables de análisis de datos como herramientas MCP.

Descripción general

Este proyecto demuestra cómo un cliente compatible con MCP puede descubrir e invocar herramientas externas de análisis de datos a través de un servidor MCP estandarizado.

El servidor analiza un conjunto de datos CSV de ventas de muestra y expone cinco herramientas:

• dataset_info - Devuelve las dimensiones del conjunto de datos y los nombres de las columnas

• dataset_summary - Devuelve estadísticas descriptivas

• missing_values - Detecta valores faltantes

• sales_by_region - Filtra registros de ventas por región

• column_analysis - Calcula estadísticas para columnas numéricas

Related MCP server: Claude Data Buddy

Arquitectura

User / AI Host | v MCP Client | v MCP Server | v MCP Tools | v Python + Pandas | v Sales CSV Dataset

Estructura del proyecto

mcp-data-analyst/ ├── data/ │ └── sample_sales.csv ├── tests/ │ └── test_analysis.py ├── tools/ │ ├── init.py │ ├── analysis_tools.py │ └── csv_tools.py ├── server.py ├── requirements.txt ├── pytest.ini ├── .gitignore └── README.md

Tecnologías

• Python

• Model Context Protocol (MCP)

• Pandas

• Pytest

• MCP Inspector

Instalación

Crea y activa un entorno virtual.

Windows PowerShell:

python -m venv venv
.\venv\Scripts\Activate.ps1