mcp-db-wrapper-example

Стартовый шаблон базы данных foro.sh: MCP-сервер, который оборачивает небольшую SQL-базу данных. Он поставляется с одной демонстрационной таблицей (notes), чтобы было что сразу запрашивать, и инструментами, которые ваш AI-агент программирования может использовать для чтения и записи данных.

Открываете это в Claude Code? Ничего устанавливать не нужно. Репозиторий содержит навыки, необходимые вашему агенту, в .claude/skills/: как развернуть этот сервер и как добавлять инструменты, которые оправдывают свою стоимость для модели.

Перед развертыванием

Без какой-либо настройки сервер работает с локальным файлом SQLite, который удаляется при каждом перезапуске и повторном развертывании — подходит для ознакомления, но не для важных данных.

Чтобы сохранять данные, установите DATABASE_URL как секрет на вкладке Secrets вашего проекта (URL вида sqlite:///, указывающий на файл в контролируемом вами томе). Для работы с другим типом базы данных см. раздел Хранилище.

Related MCP server: sqlite-mcp

Инструменты

Сделайте своим

Это отправная точка, а не готовый продукт. Откройте этот репозиторий в Claude Code (или другом AI-агенте программирования) и попросите его:

• добавить таблицы, которые действительно нужны вашему проекту

• добавить инструменты для конкретных действий с вашими данными — не просто сырые query/insert, а например find_customer(email), log_event(...)

• указать на реальную базу данных, когда она у вас появится (см. раздел Хранилище)

Для этого не нужно знать FastMCP или Model Context Protocol — опишите желаемое простым языком, и пусть агент напишет код.

Хранилище

Тип базы данных объявлен в pyproject.toml:

[tool.mcp-db-wrapper]
database = "sqlite"

server.py считывает это и отказывается запускаться, если DATABASE_URL не соответствует (например, URL не sqlite:/// при database = "sqlite"), поскольку тип — это конфигурация, а не то, что выводится из любого установленного URL.

По умолчанию, без секрета DATABASE_URL, сервер работает с /tmp/db.sqlite3, который создается автоматически, не требует настройки и удаляется при каждом перезапуске и повторном развертывании (платформа не монтирует постоянные тома). Установите DATABASE_URL на путь sqlite:/// к контролируемому вами тому, чтобы данные сохранялись. Для работы с другим типом базы данных (например, Postgres) попросите своего агента программирования заменить соответствующий драйвер и обновить database выше.

Локальный запуск

uv run server.py

Сервер использует протокол MCP через потоковый HTTP по адресу http://localhost:8000/mcp (измените порт, установив переменную PORT — то же имя, которое foro использует при развертывании).

Развертывание

Его pyproject.toml содержит всё, что нужно foro.sh, так что этот репозиторий развертывается как есть: войдите, выберите этот репозиторий, разверните.