Python Portfolio — Data Analytics MCP Server

Ein eigenständiges Demo-Portfolio-Projekt, das Python-Kenntnisse für eine Data-Analytics / KI-gestützte Entwicklungsposition demonstriert.

Es handelt sich um einen funktionierenden MCP (Model Context Protocol) Server, der Datenanalyse-Werkzeuge bereitstellt – CSV laden, zusammenfassende Statistiken berechnen, Zeilen filtern, Spalten ordnen, Korrelationen berechnen. Ein KI-Assistent (oder jeder MCP-Client) kann ihn über das Standardprotokoll steuern.

Warum ein MCP-Server? Dies ist eine echte, produktionsnahe Software-Art: Sie verbindet KI-Agenten mit Werkzeugen und Daten. Ich baue MCP-Server und KI-Agenten als Teil meiner täglichen Arbeit, und dieses Projekt zeigt genau diese Fähigkeiten in einer sauberen, eigenständigen Form.

Funktionen

• load_csv – ein CSV-Dataset einlesen, das abgeleitete Schema zurückgeben

• list_datasets – alle registrierten Datasets anzeigen

• summary – pandas describe()-Statistiken

• filter_rows – auf einer numerischen Spalte filtern (>, <, >=, …)

• top_rows – Top-N Zeilen nach einer numerischen Spalte

• correlation – Pearson-Korrelation zwischen zwei Spalten

Ein eingebauter Demo-Datensatz (campaigns) ermöglicht den sofortigen Start ohne Einrichtung.

Related MCP server: DataBeak

Schnellstart

# install deps + dev tools
uv sync --dev

# run tests (13 tests covering all tools)
uv run pytest -q

# run as an MCP server over stdio (used by MCP clients)
uv run portfolio_data_mcp.py

# run over SSE for local HTTP testing
uv run portfolio_data_mcp.py --transport sse --port 8765

Test mit der mcp CLI

# register the server so an MCP client can connect
uv run mcp install portfolio_data_mcp.py --name "portfolio-data"

Beispiel

echo 'channel,spend,conversions
social,3500,210
search,4200,330
display,3800,95
email,1100,180' | uv run python -c "
import asyncio, portfolio_data_mcp as m
asyncio.run(m.main())  # starts stdio server
"

Dann von einem MCP-Client aus:

tools: load_csv(name="x", csv_text=...)   -> schema
       summary(name="x")                  -> statistics
       top_rows(name="x", column="spend", n=3)

Projektstruktur

python-portfolio/
├── portfolio_data_mcp.py   # the MCP server (tools + logic)
├── tests/
│   └── test_portfolio_mcp.py   # 13 passing tests
├── pyproject.toml
└── README.md

Technologie

Python · MCP SDK (mcp) · pandas · pytest · Typannotationen · uv

© Volodymyr – Wien, Österreich. Teil meines Job-Such-Portfolios.