Python Portfolio — MCP сервер для анализа данных

Самодостаточный демонстрационный портфельный проект, созданный для демонстрации навыков Python, имеющих отношение к роли аналитика данных / разработчика с использованием ИИ.

Это рабочий MCP (Model Context Protocol) сервер, который предоставляет инструменты анализа данных: загрузка CSV, вычисление сводной статистики, фильтрация строк, ранжирование столбцов, вычисление корреляций. ИИ-ассистент (или любой MCP-клиент) может управлять им через стандартный протокол.

Почему MCP сервер? Это реальный, похожий на промышленный тип программного обеспечения: он соединяет ИИ-агентов с инструментами и данными. Я создаю MCP серверы и ИИ-агентов в рамках своей повседневной работы, и этот проект демонстрирует именно эти навыки в чистом, самодостаточном виде.

Возможности

• load_csv — загрузить CSV-набор данных, получить его выведенную схему

• list_datasets — показать все зарегистрированные наборы данных

• summary — статистика pandas.describe()

• filter_rows — фильтрация по числовому столбцу (>, <, >=, …)

• top_rows — top-N строк по числовому столбцу

• correlation — корреляция Пирсона между двумя столбцами

Встроенный демонстрационный набор данных (campaigns) позволяет запускать его сразу без настройки.

Related MCP server: DataBeak

Быстрый старт

# 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

Тестирование с помощью mcp CLI

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

Пример

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
"

Затем из MCP-клиента:

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

Структура проекта

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

Технологии

Python · MCP SDK (mcp) · pandas · pytest · type hints · uv

© Volodymyr — Вена, Австрия. Часть моего портфолио для поиска работы.