Python MySQL MCP

pymcp

pymcp — проект Python на основе FastMCP, предоставляющий инструменты для взаимодействия с базами данных MySQL. Этот проект поддерживает связь между серверами и клиентами и позволяет извлекать и анализировать данные с помощью различных инструментов.

Структура проекта

Установить и запустить

1. Установка зависимостей

Требуется Python 3.13 или более поздняя версия. Чтобы установить зависимости, выполните следующую команду:

2. Запустить сервер

Чтобы запустить сервер, запустите main.py :

По умолчанию сервер работает на 0.0.0.0:8080 .

3. Запустите клиент

Чтобы запустить клиент, запустите client.py :

Клиенты могут взаимодействовать с сервером для выполнения запросов MySQL или запроса списка инструментов.

Предпочтения

Настройки MySQL применяются по-разному в зависимости от среды:

• Локальная среда : src/env.py
• Среда разработки : src/env_dev.py

Среду можно задать с помощью переменной среды APP_ENV . По умолчанию используется local .

Инструменты предоставляются

Инструменты, предоставляемые сервером:

1. describe_tools
   Перечисляет доступные инструменты и объясняет, как их использовать.
2. query_mysql(sql: str)
   Выполняет заданный SQL-запрос и возвращает результаты.
   Пример: query_mysql("SELECT * FROM users LIMIT 10;")

Описание основного файла

main.py

Это точка входа для запуска сервера. Инициализируйте экземпляр MCP, зарегистрируйте инструменты, а затем запустите сервер.

client.py

Это клиентский код, который взаимодействует с сервером. Вы можете подключиться к серверу и вызвать инструмент.

src/mysql_tool.py

Это файл, определяющий инструменты, связанные с MySQL. Вы можете выполнять SQL-запросы с помощью таких инструментов, как query_mysql .

src/env.py и src/env_dev.py

Файл переменных среды, содержащий настройки подключения MySQL. Загружает соответствующие настройки в зависимости от среды.