sqlite

Сервер для работы с базами данных SQLite через MCP (Model Context Protocol). При запуске можно зарегистрировать несколько БД в формате «алиас=путь», а при вызове инструментов БД выбирается по имени алиаса. Поскольку произвольные пути к файлам во время выполнения не принимаются, это безопасно.

Функции (инструменты)

• list_databases — отображает список алиасов зарегистрированных БД

• list_tables — отображает список всех таблиц в указанной БД

• describe_table — получает схему указанной таблицы (колонки/типы/внешние ключи/индексы)

• read_query — выполняет SELECT / WITH / PRAGMA (только чтение)

• write_query — выполняет INSERT / UPDATE / DELETE / DDL (изменение данных)

list_tables/describe_table/read_query/write_query принимают произвольный аргумент database (имя алиаса). Если зарегистрирована только одна БД, его можно опустить (она автоматически становится БД по умолчанию). Если зарегистрировано две и более БД, указание database обязательно при каждом вызове.

Related MCP server: MCP SQLite Server

Настройка

npm install

Запуск

Запускается с указанием одной или нескольких БД в формате алиас=путь.

node index.js main=/path/to/main.db logs=/path/to/logs.db

Если регистрируется только одна БД (в этом случае аргумент database можно опустить):

node index.js main=/path/to/main.db

Переменные окружения

Примеры использования

// 登録済みDB一覧を確認
{ "tool": "list_databases", "arguments": {} }

// "main" DBのテーブル一覧
{ "tool": "list_tables", "arguments": { "database": "main" } }

// "logs" DBに対してクエリ
{ "tool": "read_query", "arguments": { "sql": "SELECT * FROM events", "database": "logs" } }

// DBが1つしか登録されていない場合は database 省略可
{ "tool": "read_query", "arguments": { "sql": "SELECT * FROM users" } }

Регистрация в MCP-клиенте

Claude Desktop

Добавьте следующее в claude_desktop_config.json (укажите пути как абсолютные в соответствии с вашим окружением):

{
  "mcpServers": {
    "sqlite": {
      "command": "node",
      "args": [
        "/絶対パス/sqlite-mcp-server/index.js",
        "main=/絶対パス/main.db",
        "logs=/絶対パス/logs.db"
      ]
    }
  }
}

После настройки перезапустите Claude Desktop, и инструменты сервера sqlite станут доступны.

Claude Code (CLI / расширение VS Code)

Зарегистрируйте с помощью команды claude в терминале VS Code или в обычном терминале.

claude mcp add --transport stdio sqlite -- node /絶対パス/sqlite-mcp-server/index.js main=/絶対パス/main.db logs=/絶対パス/logs.db

• Всё, что идёт после --, передаётся как команда запуска сервера.

• Чтобы включить режим только для чтения, добавьте --env SQLITE_READONLY=1:

  claude mcp add --transport stdio --env SQLITE_READONLY=1 sqlite -- node /絶対パス/index.js main=/絶対パス/main.db

• По умолчанию используется локальная область видимости (только для текущего проекта). Для использования во всех проектах добавьте --scope user, а для совместного использования командой в виде .mcp.json — --scope project.

  claude mcp add --transport stdio --scope user sqlite -- node /絶対パス/index.js main=/絶対パス/main.db

Проверка и удаление зарегистрированных записей:

claude mcp list
claude mcp remove sqlite

Когда вы откроете панель Claude Code в VS Code (или запустите сеанс claude), станут доступны такие инструменты, как list_databases и read_query.

Примечания

• Для write_query рекомендуется использовать плейсхолдеры ? (аргумент params) для защиты от SQL-инъекций.

• Имена таблиц проверяются: допускаются только буквенно-цифровые символы и подчёркивания.

• В именах алиасов можно использовать только буквенно-цифровые символы, подчёркивания и дефисы.

• Подключение к каждой БД открывается при первом обращении и в дальнейшем переиспользуется. При завершении сервера все подключения закрываются.

• Доступ к БД, не зарегистрированным при запуске, невозможен (произвольные пути не принимаются).

• При подключении к производственной базе данных рассмотрите запуск с SQLITE_READONLY=1.