база данных-mcp

База данных MCP Server (от Legion AI)

Сервер, который помогает людям получать доступ к данным в базах данных и выполнять запросы с помощью Legion Query Runner с интеграцией Model Context Protocol (MCP) Python SDK.

Начните генерацию здесь

Этот инструмент предоставлен Legion AI . Чтобы использовать полноценный и мощный инструмент аналитики данных AI, посетите сайт.

Конец поколения здесь

Функции

Доступ к базе данных через Legion Query Runner
Поддержка протокола контекста модели (MCP) для помощников на основе искусственного интеллекта
Раскройте операции с базой данных как ресурсы, инструменты и подсказки MCP
Несколько вариантов развертывания (автономный сервер MCP, интеграция FastAPI)
Выполнение запроса и обработка результатов
Гибкая настройка с помощью переменных среды, аргументов командной строки или настроек MCP JSON

Поддерживаемые базы данных

База данных	Код DB_TYPE
PostgreSQL	стр.
Красное смещение	красное смещение
CockroachDB	таракан
MySQL	mysql
RDS MySQL	rds_mysql
Microsoft SQL-сервер	mssql
Большой запрос	bigquery
Oracle БД	оракул
SQLite	sqlite

Мы используем библиотеку Legion Query Runner в качестве коннекторов. Вы можете найти больше информации в их api doc .

Что такое МКП?

Model Context Protocol (MCP) — это спецификация для поддержания контекста в приложениях ИИ. Этот сервер использует MCP Python SDK для:

Использовать операции с базами данных в качестве инструментов для помощников на основе искусственного интеллекта
Предоставить схемы баз данных и метаданные в качестве ресурсов
Генерировать полезные подсказки для операций с базой данных
Включить взаимодействие с базами данных с отслеживанием состояния

Установка и настройка

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

Для всех методов установки требуются два параметра:

DB_TYPE : Код типа базы данных (см. таблицу выше)
DB_CONFIG : строка конфигурации JSON для подключения к базе данных

Формат DB_CONFIG зависит от типа базы данных. Подробности конфигурации для конкретной базы данных см. в документации API.

Методы установки

Вариант 1: Использование УФ (рекомендуется)

При использовании uv , не требуется специальной установки. Мы будем использовать uvx для прямого запуска database-mcp .

Пример конфигурации УФ:

REPLACE DB_TYPE and DB_CONFIG with your connection info.
{
    "mcpServers": {
      "database-mcp": {
        "command": "uvx",
        "args": [
          "database-mcp"
        ],
        "env": {
          "DB_TYPE": "pg",
          "DB_CONFIG": "{\"host\":\"localhost\",\"port\":5432,\"user\":\"user\",\"password\":\"pw\",\"dbname\":\"dbname\"}"
        },
        "disabled": true,
        "autoApprove": []
      }
    }
}

Вариант 2: использование PIP

Установка через pip:

pip install database-mcp

Пример конфигурации PIP:

{
  "mcpServers": {
    "database": {
      "command": "python",
      "args": [
        "-m", "database_mcp", 
        "--repository", "path/to/git/repo"
      ],
      "env": {
        "DB_TYPE": "pg",
        "DB_CONFIG": "{\"host\":\"localhost\",\"port\":5432,\"user\":\"user\",\"password\":\"pw\",\"dbname\":\"dbname\"}"
      }
    }
  }
}

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

Режим разработки

mcp dev mcp_server.py

Режим производства

python mcp_server.py

Методы конфигурации

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

export DB_TYPE="pg"  # or mysql, postgresql, etc.
export DB_CONFIG='{"host":"localhost","port":5432,"user":"username","password":"password","dbname":"database_name"}'
mcp dev mcp_server.py

Аргументы командной строки

python mcp_server.py --db-type pg --db-config '{"host":"localhost","port":5432,"user":"username","password":"password","dbname":"database_name"}'

Или с УФ:

uv mcp_server.py --db-type pg --db-config '{"host":"localhost","port":5432,"user":"username","password":"password","dbname":"database_name"}'

Раскрытые возможности MCP

Ресурсы

Ресурс	Описание
`schema://all`	Получить полную схему базы данных

Инструменты

Инструмент	Описание
`execute_query`	Выполнить SQL-запрос и вернуть результаты в виде таблицы разметки
`execute_query_json`	Выполнить SQL-запрос и вернуть результаты в формате JSON
`get_table_columns`	Получить имена столбцов для определенной таблицы
`get_table_types`	Получить типы столбцов для определенной таблицы
`get_query_history`	Получить недавнюю историю запросов

Подсказки

Быстрый	Описание
`sql_query`	Создать SQL-запрос к базе данных
`explain_query`	Объясните, что делает SQL-запрос
`optimize_query`	Оптимизируйте SQL-запрос для повышения производительности

Разработка

Тестирование

uv pip install -e ".[dev]"
pytest

Издательский

rm -rf dist/ build/ *.egg-info/ && python -m build
python -m build
python -m twine upload dist/*

Лицензия

Этот репозиторий лицензирован по GPL

database-mcp

Integrations