SQLite MCP-сервер

Обзор

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

Related MCP server: Database MCP Server

Компоненты

Ресурсы

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

• 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 в репозитории проекта.