SQLite MCP-сервер

Обзор

Реализация сервера Model Context Protocol (MCP), которая обеспечивает взаимодействие с базой данных и возможности бизнес-аналитики через SQLite. Этот сервер позволяет выполнять SQL-запросы, анализировать бизнес-данные и автоматически генерировать бизнес-инсайты.

Компоненты

Ресурсы

Сервер предоставляет один динамический ресурс:

memo://insights : постоянно обновляемая записка с бизнес-информацией, которая объединяет обнаруженные в ходе анализа сведения.
- Автоматические обновления по мере обнаружения новых аналитических данных с помощью инструмента append-insight

Подсказки

Сервер предоставляет демонстрационную подсказку:

mcp-demo : интерактивная подсказка, которая помогает пользователям выполнять операции с базой данных
- Обязательный аргумент: topic — анализируемая область бизнеса
- Создает соответствующие схемы базы данных и образцы данных
- Направляет пользователей через анализ и генерацию идей
- Интегрируется с памяткой по бизнес-анализу

Инструменты

Сервер предлагает шесть основных инструментов:

Инструменты запроса

read_query
- Выполнение запросов SELECT для чтения данных из базы данных
- Вход:
  - query (строка): SQL-запрос SELECT для выполнения
- Возвращает: результаты запроса в виде массива объектов.
write_query
- Выполнение запросов INSERT, UPDATE или DELETE
- Вход:
  - query (строка): запрос на изменение SQL
- Возвращает: { affected_rows: number }
create_table
- Создать новые таблицы в базе данных
- Вход:
  - query (строка): SQL-оператор CREATE TABLE
- Возврат: Подтверждение создания таблицы

Инструменты схемы

list_tables
- Получить список всех таблиц в базе данных
- Ввод не требуется
- Возвращает: Массив имен таблиц.
describe-table
- Просмотр информации о схеме для определенной таблицы
- Вход:
  - table_name (string): Имя таблицы для описания
- Возвращает: Массив определений столбцов с именами и типами.

Инструменты анализа

append_insight
- Добавьте новые бизнес-идеи в ресурс памятки
- Вход:
  - insight (строка): Бизнес-инсайт, полученный в результате анализа данных.
- Возврат: Подтверждение добавления инсайта
- Запускает обновление ресурса memo://insights

Использование с Claude Desktop

уф

# Add the server to your claude_desktop_config.json
"mcpServers": {
  "sqlite": {
    "command": "uv",
    "args": [
      "--directory",
      "parent_of_servers_repo/servers/src/sqlite",
      "run",
      "mcp-server-sqlite",
      "--db-path",
      "~/test.db"
    ]
  }
}

Докер

# Add the server to your claude_desktop_config.json
"mcpServers": {
  "sqlite": {
    "command": "docker",
    "args": [
      "run",
      "--rm",
      "-i",
      "-v",
      "mcp-test:/mcp",
      "mcp/sqlite",
      "--db-path",
      "/mcp/test.db"
    ]
  }
}

Использование с VS Code

Для быстрой установки нажмите кнопки установки ниже:

Для ручной установки добавьте следующий блок JSON в файл настроек пользователя (JSON) в VS Code. Это можно сделать, нажав Ctrl + Shift + P и введя Preferences: Open Settings (JSON) .

При желании вы можете добавить его в файл .vscode/mcp.json в вашем рабочем пространстве. Это позволит вам поделиться конфигурацией с другими.

Обратите внимание, что ключ mcp необходим при использовании файла mcp.json .

уф

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "db_path",
        "description": "SQLite Database Path",
        "default": "${workspaceFolder}/db.sqlite"
      }
    ],
    "servers": {
      "sqlite": {
        "command": "uvx",
        "args": [
          "mcp-server-sqlite",
          "--db-path",
          "${input:db_path}"
        ]
      }
    }
  }
}

Докер

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "db_path",
        "description": "SQLite Database Path (within container)",
        "default": "/mcp/db.sqlite"
      }
    ],
    "servers": {
      "sqlite": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-v",
          "mcp-sqlite:/mcp",
          "mcp/sqlite",
          "--db-path",
          "${input:db_path}"
        ]
      }
    }
  }
}

Здание

Докер:

docker build -t mcp/sqlite .

Тест с инспектором MCP

uv add "mcp[cli]"
mcp dev src/mcp_server_sqlite/server.py:wrapper  

Лицензия

Этот сервер MCP лицензирован по лицензии MIT. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение в соответствии с условиями лицензии MIT. Для получения более подробной информации см. файл LICENSE в репозитории проекта.

SQLite MCP Server

Integrations