shop-db MCP Server

Сервер Model Context Protocol только для чтения, который предоставляет AI-агентам аналитический доступ к базе данных SQLite электронной коммерции (customers, orders, order_items, products) — без какой-либо возможности изменять данные.

Создан для Node.js v24.19+, запускает исходные файлы TypeScript напрямую (без этапа сборки) с использованием нативных node:sqlite и node:test.

Установка

npm install

Репозиторий уже содержит заполненную базу ./shop.db в корне проекта — этап заполнения не требуется. Ни npm start, ни npm test не записывают в неё: сервер открывает её только для чтения, а набор тестов создаёт собственные временные базы в tests/ из tests/fixtures/seed.sql.

Related MCP server: shop-mcp

Запуск сервера

npm start

Сервер взаимодействует через stdio (StdioServerTransport) — он предназначен для запуска MCP-клиентом (Claude Code, Claude Desktop и т. д.), а не для интерактивной работы.

Тесты

npm test

Запускает node --test для tests/, покрывая крайние случаи проверки SQL (ключевые слова мутации, обход через комментарии, многооператорные инъекции, CTE, EXPLAIN) и все три MCP-инструмента сквозным тестированием на изолированных тестовых базах, созданных из tests/fixtures/seed.sql. Зафиксированная база ./shop.db не читается и не записывается набором тестов.

Настройка пути к базе данных

По умолчанию сервер читает ./shop.db (относительно рабочего каталога, из которого он запущен). Переопределите с помощью переменной окружения DB_PATH:

DB_PATH=/absolute/path/to/shop.db npm start

Инструменты

• list_tables — выводит список 4 таблиц с кратким описанием каждой.

• describe_table — определения столбцов, типы, первичные ключи и до 3 примеров строк для одной таблицы (tableName) или всех таблиц (если опустить).

• read_query — выполняет запрос только для чтения SELECT/WITH/EXPLAIN/PRAGMA (query, обязательный) и возвращает до limit строк (необязательно, по умолчанию 100, максимум 1000). Любая попытка мутации (INSERT, UPDATE, DELETE, DROP, ...) отклоняется с понятной ошибкой, даже если она замаскирована SQL-комментариями или обёрнута в CTE.

Конфигурация AI-агента

{
  "mcpServers": {
    "shop-db": {
      "command": "node",
      "args": ["/absolute/path/to/src/index.ts"],
      "env": {
        "DB_PATH": "/absolute/path/to/shop.db"
      }
    }
  }
}

Документация проекта

• AGENTS.md — инструкции для AI-агентов, работающих с кодом в этом репозитории (также загружается как CLAUDE.md через символическую ссылку).

• CONTEXT.md — доменная модель и архитектура безопасности.