MCP SQL Server (Разработка)

Профессиональный MCP-сервер для подключения любой совместимой с MCP LLM к базе данных SQL и выполнения:

• Запросов (SELECT, WITH, SHOW и т. д.)

• DML (INSERT, UPDATE, DELETE)

• DDL (CREATE, ALTER и опционально DROP/TRUNCATE)

Этот сервер предназначен для личного использования при разработке с поддержкой ИИ.

Возможности

• Протокол MCP через stdio (совместим с MCP-клиентами).

• Подключение к нескольким движкам через SQLAlchemy (sqlite, postgresql, mysql, mssql и т. д.).

• Инструменты MCP, ориентированные на повседневные операции:

  • sql_capabilities

  • sql_list_tables

  • sql_describe_table

  • sql_run

  • sql_run_script

• Блокировка деструктивных DDL по умолчанию (DROP/TRUNCATE заблокированы).

• Настраиваемый лимит строк и операторов в скрипте.

Установка

python -m venv .venv
source .venv/bin/activate
pip install -e .

Конфигурация (переменные окружения)

Префикс: MCP_SQL_

• MCP_SQL_DATABASE_URL: URL SQLAlchemy. По умолчанию: sqlite:///./dev.db

• MCP_SQL_MAX_ROWS: максимальное количество строк, возвращаемых запросом. По умолчанию: 200

• MCP_SQL_MAX_SCRIPT_STATEMENTS: максимальное количество операторов в скрипте. По умолчанию: 100

• MCP_SQL_ALLOW_DESTRUCTIVE_DDL: true/false для разрешения DROP и TRUNCATE. По умолчанию: false

Пример

export MCP_SQL_DATABASE_URL='postgresql+psycopg://dev_user:dev_pass@localhost:5432/devdb'
export MCP_SQL_MAX_ROWS=500
export MCP_SQL_ALLOW_DESTRUCTIVE_DDL=false

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

mcp-sql-server

Также можно запустить его как модуль:

python -m mcp_sql_server.server

Запуск двойным кликом в Windows

Включен файл start_mcp_sql_server.bat для упрощения запуска:

1. Автоматически создает .venv (если он не существует).

2. Устанавливает/обновляет зависимости.

3. Запускает MCP-сервер.

Просто дважды кликните по этому .bat файлу.

Конфигурация в MCP-клиенте (общий пример)

{
  "mcpServers": {
    "sql-dev": {
      "command": "mcp-sql-server",
      "env": {
        "MCP_SQL_DATABASE_URL": "sqlite:///./dev.db",
        "MCP_SQL_MAX_ROWS": "200",
        "MCP_SQL_ALLOW_DESTRUCTIVE_DDL": "false"
      }
    }
  }
}

Рекомендуемый рабочий процесс

1. sql_capabilities для проверки активной конфигурации.

2. sql_list_tables для изучения схемы.

3. sql_describe_table для проверки метаданных.

4. sql_run для запросов или точечных DML-операций.

5. sql_run_script для пакетов контролируемых изменений.

Рекомендации для разработки с поддержкой ИИ

• Используйте пользователей базы данных с минимальными привилегиями.

• Работайте с локальной базой данных разработки или временным снимком (snapshot).

• Держите MCP_SQL_ALLOW_DESTRUCTIVE_DDL=false по умолчанию.

• Версионируйте структурные изменения с помощью миграций.

Примечание по безопасности

Этот проект не предназначен для промышленной эксплуатации. Он ориентирован на локальную продуктивность в средах разработки.

Руководство для Claude в VS Code

Ознакомьтесь с README_CLAUDE_VSCODE.md для получения полного примера настройки и использования.