Database Explorer MCP

Сервер FastMCP для изучения реляционных баз данных и безопасного выполнения запросов к ним. В качестве локальной базы данных для разработки используется SQLite; SQLAlchemy также поддерживает PostgreSQL и MySQL через их драйверы.

Архитектура

MCP-клиент выполняет рассуждения на естественном языке и генерирует SQL. Этот сервер предоставляет инструменты для работы с базой данных, проверяет запросы только на чтение, выполняет их и возвращает структурированные результаты.

MCP client LLM -> FastMCP tools -> safety layer -> SQLAlchemy -> database

Сервер не обращается к Anthropic, поэтому ключ API Anthropic не требуется.

Related MCP server: nl2sql-mcp

Настройка

Установите uv, затем из этого каталога выполните:

uv sync
uv run python tests/seed_test_db.py
uv run pytest

Если uv ещё нет в PATH, используйте:

py -m uv sync
py -m uv run pytest

База данных по умолчанию:

sqlite:///sample.db

Чтобы использовать другую базу данных, задайте DATABASE_URL перед запуском сервера. Примеры:

$env:DATABASE_URL = "sqlite:///C:/data/example.db"
$env:DATABASE_URL = "postgresql+psycopg2://user:password@localhost:5432/example"
$env:DATABASE_URL = "mysql+pymysql://user:password@localhost:3306/example"

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

uv run server.py

Общая конфигурация MCP для VS Code находится в .vscode/mcp.json. Она запускает сервер через stdio и может использоваться с MCP-совместимыми клиентами и Inspector.

Для удалённого размещения используйте Streamable HTTP:

$env:MCP_TRANSPORT = "streamable-http"
$env:MCP_HOST = "0.0.0.0"
$env:MCP_PORT = "8000"
uv run server.py

Удалённое развёртывание должно обеспечивать аутентификацию и защищать DATABASE_URL с помощью конфигурации секретов.

Инструменты

• explore_schema: вывести список таблиц или изучить одну таблицу

• execute_query: выполнить один безопасный SELECT только для чтения

• explain_query: вернуть собственный план выполнения

• validate_schema: сообщать об отсутствующих первичных ключах и неиндексированных внешних ключах

• suggest_index: предлагать индексы на основе метаданных таблицы или плана запроса

• migration_context: предоставлять контекст схемы для генерации миграций на стороне клиента

• validate_migration: проверять предлагаемые скрипты UP и DOWN без их выполнения

Каждое выполнение запроса и объяснение проходят через уровень безопасности. Изменяющие операторы, комментарии и множественные операторы отклоняются. По умолчанию результаты запросов содержат не более 100 строк.

Тесты

uv run pytest

Набор тестов использует временные базы данных SQLite и не требует внешних учётных данных или запущенного сервера базы данных.

Удалённое развёртывание

См. DEPLOYMENT.md: шаги развёртывания FastMCP Horizon, требования к удалённой базе данных и контрольный список аутентификации.