SQLite Explorer MCP-сервер

Сервер MCP, который обеспечивает безопасный доступ только для чтения к базам данных SQLite через Model Context Protocol (MCP). Этот сервер создан с использованием фреймворка FastMCP, который позволяет LLM исследовать и запрашивать базы данных SQLite со встроенными функциями безопасности и проверки запросов.

📋 Системные требования

• Питон 3.6+

• Файл базы данных SQLite (путь указан через переменную среды)

Related MCP server: Jewei MSSQL MCP Server

📦 Зависимости

Установите все необходимые зависимости:

# Using pip
pip install -r requirements.txt

Требуемые пакеты

• fastmcp : Фреймворк для построения серверов Model Context Protocol

Все зависимости указаны в requirements.txt для легкой установки.

📑 Содержание

• Системные требования

• Зависимости

• Инструменты МКП

• Начиная

• Варианты установки

  • Клод Десктоп

  • Плагин Cline VSCode

• Функции безопасности

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

• Переменные среды

🛠️ Инструменты MCP

Сервер предоставляет следующие инструменты для LLM:

read_query

Выполнение запроса SELECT в базе данных со встроенными проверками безопасности. Особенности:

• Проверка и очистка запросов

• Поддержка привязки параметров

• Соблюдение лимита строк

• Результаты отформатированы как словари

список_таблиц

Перечислите все доступные таблицы в базе данных с их названиями.

описать_таблицу

Получите подробную информацию о схеме для конкретной таблицы, включая:

• Названия и типы столбцов

• Ограничения NULL

• Значения по умолчанию

• Первичная ключевая информация

🚀 Начало работы

Клонируйте репозиторий:

git clone https://github.com/hannesrudolph/sqlite-explorer-fastmcp-mcp-server.git
cd sqlite-explorer-fastmcp-mcp-server

📦 Варианты установки

Вы можете установить этот сервер MCP либо в Claude Desktop, либо в плагине Cline VSCode. Выберите вариант, который лучше всего соответствует вашим потребностям.

Вариант 1: Установка для Claude Desktop

Установка с помощью FastMCP:

fastmcp install sqlite_explorer.py --name "SQLite Explorer" -e SQLITE_DB_PATH=/path/to/db

Замените /path/to/db на путь к файлу вашей базы данных SQLite.

Вариант 2: Установка плагина Cline VSCode

Чтобы использовать этот сервер с плагином Cline VSCode :

1. В VSCode щелкните значок сервера (☰) на боковой панели плагина Cline.

2. Нажмите кнопку «Изменить настройки MCP» (✎)

3. Добавьте следующую конфигурацию в файл настроек:

{
  "sqlite-explorer": {
    "command": "uv",
    "args": [
      "run",
      "--with",
      "fastmcp",
      "--with",
      "uvicorn",
      "fastmcp",
      "run",
      "/path/to/repo/sqlite_explorer.py"
    ],
    "env": {
      "SQLITE_DB_PATH": "/path/to/your/database.db"
    }
  }
}

Заменять:

• /path/to/repo с полным путем к месту, куда вы клонировали этот репозиторий (например, /Users/username/Projects/sqlite-explorer-fastmcp-mcp-server )

• /path/to/your/database.db с полным путем к файлу вашей базы данных SQLite

🔒 Функции безопасности

• Доступ только для чтения к базам данных SQLite

• Проверка и очистка запросов

• Привязка параметров для безопасного выполнения запроса

• Соблюдение лимита строк

• Подавление вывода прогресса для чистых ответов JSON

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

Репозиторий включает файлы документации для разработки:

• mcp-documentation.txt : Содержит подробную документацию по реализации сервера MCP и использованию фреймворка FastMCP.

Эта документация служит контекстом при разработке функций и может использоваться совместно со студентами магистратуры (LLM) для оказания помощи в разработке.

⚙️ Переменные среды

Необходимо установить следующие переменные среды:

• SQLITE_DB_PATH : Полный путь к файлу базы данных SQLite, который вы хотите просмотреть.