Локальный сервер аналитики базы данных MCP

Python-сервер Model Context Protocol (MCP), который предоставляет локальную базу данных SQLite для аналитики электронной коммерции таким ИИ-ассистентам, как Claude. Построен на FastMCP, SQLAlchemy и Pandas.

Что такое MCP? Протокол Model Context Protocol (от Anthropic) позволяет ИИ-моделям безопасно взаимодействовать с локальными инструментами и данными. Этот сервер знакомит Claude с вашей базой данных, чтобы он мог запрашивать, анализировать и объяснять данные — всё с помощью естественного языка.

Возможности

Инструменты (всего 11)

Ресурсы

Промпты

• analyze_table — Полный статистический анализ любой таблицы

• business_summary — Исполнительный отчёт по электронной коммерции

• find_anomalies — Обнаружение проблем качества данных и выбросов

Related MCP server: agente-mcp-streamlit-ecommerce

Схема базы данных

customers ──< orders ──< order_items >── products

• customers: 15 записей с именем, email, городом и датой регистрации

• products: 15 товаров по категориям Electronics, Books, Sports, Home, Stationery

• orders: 60 заказов со статусом (completed/pending/cancelled) и итогами

• order_items: позиции, связывающие заказы и товары

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

MCP_Server/
├── server.py               # FastMCP server entry point
├── requirements.txt        # Python dependencies
├── database/
│   ├── engine.py           # SQLAlchemy DB connection
│   └── seed_data.py        # Seed script (creates + populates DB)
├── tools/
│   ├── query.py            # Core SQL tools (Phase 2)
│   └── analytics.py        # Analytics tools (Phase 3)
├── resources/
│   └── schema.py           # DB schema as MCP resources
├── prompts/
│   └── templates.py        # Pre-built analyst prompts
├── tests/
│   └── test_tools.py       # Unit tests
└── data/
    └── analytics.db        # SQLite database (auto-created)

Начало работы

1. Клонируйте репозиторий

git clone https://github.com/manohar135/Local-Database-Analytics-MCP-Server.git
cd Local-Database-Analytics-MCP-Server

2. Создайте виртуальное окружение и установите зависимости

python -m venv .venv
source .venv/bin/activate       # On Windows: .venv\Scripts\activate
pip install -r requirements.txt

3. Заполните базу данных

python database/seed_data.py

4. Запустите MCP Inspector (режим разработки)

fastmcp dev server.py

5. Запустите тесты

pytest tests/ -v

Технологический стек

Примеры диалогов с Claude

После подключения к Claude Desktop попробуйте:

• «Какие таблицы вам доступны?»

• «Дайте мне бизнес-сводку данных о продажах»

• «Какие товары продаются лучше всего?»

• «Есть ли проблемы с качеством данных в таблице orders?»

• «Покажите тренды месячной выручки за последний год»