MCP-сервер с несколькими базами данных
Обзор
DB MCP Server предоставляет стандартизированный способ для моделей ИИ одновременно взаимодействовать с несколькими базами данных. Созданный на основе фреймворка FreePeak/cortex , он позволяет помощникам ИИ выполнять SQL-запросы, управлять транзакциями, исследовать схемы и анализировать производительность в различных системах баз данных через унифицированный интерфейс.
Основные концепции
Поддержка нескольких баз данных
В отличие от традиционных коннекторов баз данных, DB MCP Server может подключаться и взаимодействовать с несколькими базами данных одновременно:
Динамическая генерация инструментов
Для каждой подключенной базы данных сервер автоматически генерирует специализированные инструменты:
Чистая Архитектура
Сервер следует принципам чистой архитектуры и состоит из следующих слоев:
- Уровень домена : основные бизнес-сущности и интерфейсы
- Уровень репозитория : Реализации доступа к данным
- Уровень варианта использования : бизнес-логика приложения
- Уровень доставки : Внешние интерфейсы (инструменты MCP)
Функции
- Одновременная поддержка нескольких баз данных : одновременное подключение к нескольким базам данных MySQL и PostgreSQL
- Генерация инструментов для конкретной базы данных : автоматическое создание специализированных инструментов для каждой подключенной базы данных.
- Чистая архитектура : модульная конструкция с четким разделением задач
- Совместимость с OpenAI Agents SDK : полная совместимость для бесшовной интеграции помощника ИИ
- Инструменты динамической базы данных : выполнение запросов, запуск операторов, управление транзакциями, исследование схем, анализ производительности.
- Унифицированный интерфейс : единообразные шаблоны взаимодействия между различными типами баз данных
- Управление соединениями : простая настройка для нескольких соединений с базой данных.
Поддерживаемые базы данных
База данных | Статус | Функции |
---|---|---|
MySQL | ✅ Полная поддержка | Запросы, транзакции, анализ схемы, анализ производительности |
PostgreSQL | ✅ Полная поддержка (v9.6-17) | Запросы, транзакции, анализ схемы, анализ производительности |
TimescaleDB | ✅ Полная поддержка | Гипертаблицы, запросы временных рядов, непрерывные агрегаты, сжатие, политики хранения |
Варианты развертывания
Сервер DB MCP можно развернуть несколькими способами в зависимости от различных сред и потребностей интеграции:
Развертывание Docker
Примечание : Монтируйте в
/app/my-config.json
, так как в контейнере есть файл по умолчанию в/app/config.json
.
Режим STDIO (интеграция с IDE)
Для интеграции Cursor IDE добавьте в .cursor/mcp.json
:
Режим SSE (события, отправленные сервером)
Конечная точка клиентского подключения: http://localhost:9092/sse
Установка исходного кода
Конфигурация
Файл конфигурации базы данных
Создайте файл config.json
с подключениями к вашей базе данных:
Параметры командной строки
Доступные инструменты
Для каждой подключенной базы данных DB MCP Server автоматически генерирует следующие специализированные инструменты:
Инструменты запроса
Название инструмента | Описание |
---|---|
query_<db_id> | Выполнять запросы SELECT и получать результаты в виде табличного набора данных |
execute_<db_id> | Выполнение операторов манипулирования данными (INSERT, UPDATE, DELETE) |
transaction_<db_id> | Начало, фиксация и откат транзакций |
Инструменты схемы
Название инструмента | Описание |
---|---|
schema_<db_id> | Получите информацию о таблицах, столбцах, индексах и внешних ключах |
generate_schema_<db_id> | Генерация SQL или кода из схемы базы данных |
Инструменты производительности
Название инструмента | Описание |
---|---|
performance_<db_id> | Анализируйте производительность запросов и получайте предложения по оптимизации |
Инструменты TimescaleDB
Для баз данных PostgreSQL с расширением TimescaleDB доступны следующие дополнительные специализированные инструменты:
Название инструмента | Описание |
---|---|
timescaledb_<db_id> | Выполнение общих операций TimescaleDB |
create_hypertable_<db_id> | Преобразовать стандартную таблицу в гипертаблицу TimescaleDB |
list_hypertables_<db_id> | Список всех гипертаблиц в базе данных |
time_series_query_<db_id> | Выполнение оптимизированных запросов временных рядов с сегментированием |
time_series_analyze_<db_id> | Анализировать закономерности временных рядов данных |
continuous_aggregate_<db_id> | Создавайте материализованные представления, которые автоматически обновляются |
refresh_continuous_aggregate_<db_id> | Обновлять непрерывные агрегаты вручную |
Подробную документацию по инструментам TimescaleDB см. в TIMESCALEDB_TOOLS.md .
Примеры
Запрос к нескольким базам данных
Управление транзакциями
Изучение схемы базы данных
Поиск неисправностей
Распространенные проблемы
- Ошибки подключения : проверьте сетевое подключение и учетные данные базы данных.
- Ошибки прав доступа : убедитесь, что у пользователя базы данных есть соответствующие права доступа.
- Проблемы с тайм-аутом : проверьте настройку
query_timeout
в вашей конфигурации.
Журналы
Включите подробное ведение журнала для устранения неполадок:
Внося вклад
Мы приветствуем вклад в проект DB MCP Server! Чтобы внести вклад:
- Форк репозитория
- Создайте ветку функций (
git checkout -b feature/amazing-feature
) - Зафиксируйте свои изменения (
git commit -m 'feat: add amazing feature'
) - Отправить в ветку (
git push origin feature/amazing-feature
) - Открыть запрос на извлечение
Подробные инструкции см. в нашем файле CONTRIBUTING.md .
Лицензия
Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Multi DB MCP Server — это высокопроизводительная реализация Database Model Context Protocol, разработанная для революционного изменения взаимодействия агентов ИИ с базами данных. В настоящее время поддерживает базы данных MySQL и PostgreSQL.
Related MCP Servers
- -securityAlicense-qualityMCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.Last updated -14TypeScriptMIT License
- -securityAlicense-qualityMCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.Last updated -433TypeScriptMIT License
- AsecurityAlicenseAqualityA blazing fast MCP server that enables AI agents to interact with multiple PostgreSQL databases, providing functionality to list tables, inspect schemas, execute queries, and run transactions.Last updated -442TypeScriptMIT License
- AsecurityFlicenseAqualityAn all-in-one Model Context Protocol (MCP) server that connects your coding AI to numerous databases, data warehouses, data pipelines, and cloud services, streamlining development workflow through seamless integrations.Last updated -2Python