xiyan_mcp_server

xiyan_mcp_server — MCP-сервер сообщества (автор — XGenerationLab). Запросы к базам данных на естественном языке через модель XiyanSQL. Ставится через pip. Лицензия Apache-2.0.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
XGenerationLab
Лицензия
Apache-2.0
Транспорт
stdio
Авторизация
api_key
ОС
Не указана
Языки
python

Уровень риска: medium

Выполняет сгенерированный SQL с правами пользователя базы; в удалённом режиме вопросы уходят во внешний сервис модели.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"xiyan-mcp-server\": {\n      \"command\": \"/xxx/python\",\n      \"args\": [\n        \"-m\",\n        \"xiyan_mcp_server\"\n      ],\n      \"env\": {\n        \"YML\": \"path/to/yml\"\n      }\n    }\n  }\n}",
    "lang": "json",
    "notes": "Дословно из README, вариант stdio",
    "verified": "docs"
}

Что умеет

XiYan MCP Server позволяет получать данные из базы обычными фразами. Сервер переводит вопрос на естественном языке в SQL с помощью модели XiYanSQL, выполняет запрос и возвращает результат. Поддерживаются MySQL и PostgreSQL.

Что даёт сервер:

  • инструмент get_data — вопрос на естественном языке превращается в SQL встроенной моделью, запрос выполняется в базе, и результат возвращается ассистенту;
  • ресурс {dialect}:// — список таблиц текущей базы;
  • ресурс {dialect}://{table_name} — пример данных из указанной таблицы, чтобы модель понимала её структуру.

Для перевода в SQL можно использовать модели общего назначения (например, GPT или Qwen-max), специализированную модель XiYanSQL-QwenCoder-32B (через ModelScope или пробный доступ в Alibaba Cloud DashScope) или локальную модель. Локальный режим не требует ключа API и считается самым безопасным, но работает медленнее.

По результатам бенчмарка MCPBench, приведённым в README, сервер опережает MCP-серверы для MySQL и PostgreSQL на 2–22 процентных пункта.

Кому подойдёт

  • Аналитикам и менеджерам, которым нужны данные из базы без написания SQL.
  • Разработчикам: быстрые ответы о содержимом таблиц в диалоге с ассистентом.
  • Командам с требованиями к безопасности: полностью локальный режим без внешних API.

Похожие серверы — в категории базы данных.

Установка

Нужен Python 3.11 или новее:

pip install xiyan-mcp-server

Для PostgreSQL дополнительно установите psycopg2. Сервер настраивается файлом YAML, путь к которому передаётся в переменной YML. В файле три раздела: mcp — транспорт (stdio или sse, порт по умолчанию 8000), model — имя модели, ключ и адрес API, database — адрес, порт, пользователь, пароль и имя базы; для PostgreSQL добавьте dialect: "postgresql". Шаблон — файл config_demo.yml в репозитории.

Подключение к клиентам

Конфиги приведены дословно из README. Укажите полный путь к интерпретатору Python вместо /xxx/python (его покажет which python) и путь к своему файлу YAML. Подробнее — в инструкции как подключить MCP.

{
    "mcpServers": {
        "xiyan-mcp-server": {
            "command": "/xxx/python",
            "args": [
                "-m",
                "xiyan_mcp_server"
            ],
            "env": {
                "YML": "PATH/TO/YML"
            }
        }
    }
}

Claude Desktop не поддерживает транспорт SSE, поэтому для него нужен stdio. Для Cursor в README есть и вариант с SSE по адресу http://localhost:8000/sse. Для Cline используется тот же конфиг, что и для Claude Desktop.

Проверка

Попросите ассистента показать список таблиц базы — он прочитает ресурс со списком. Затем задайте вопрос о данных, например сколько записей в одной из таблиц.

Примеры задач

Сколько заказов было за прошлый месяц и какой средний чек?
Покажи десять клиентов с наибольшей суммой покупок.

Риски

  • Доступ к базе. Сервер выполняет SQL, сгенерированный моделью, с правами указанного пользователя. Подключайте учётную запись только для чтения.
  • Пароли и ключи. Пароль базы и ключ API модели хранятся в файле YAML; не публикуйте его.
  • Передача данных. В удалённом режиме вопросы и сведения о структуре таблиц отправляются во внешний сервис модели. Для конфиденциальных данных используйте локальную модель.
  • Пробный доступ. Ключ DashScope выдаётся по запросу на почту и истекает через месяц или 200 запросов; для продакшена он не предназначен.

Частые вопросы

Можно ли работать без внешних API?

Да. В локальном режиме модель разворачивается на вашем сервере, и ключ API не нужен.

Какие базы данных поддерживаются?

MySQL и PostgreSQL; поддержку других диалектов авторы обещают позже.

Почему Claude Desktop не находит Python?

В конфиге нужен полный путь к интерпретатору Python. Узнать его можно командой which python.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

dbx

Запросы агентов к базам данных через подключения, настроенные в DBX.

Риск: medium Лицензия: Apache-2.0 ★ 29 956

XERJ

Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.

Риск: high Лицензия: Apache-2.0 ★ 18 558

MCP Toolbox for Databases

MCP Toolbox for Databases от Google подключает агента к вашим базам данных.

Риск: medium Лицензия: Apache-2.0 ★ 16 830

kubeshark

Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.

Риск: medium Лицензия: Apache-2.0 ★ 12 135

Источники