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 с правами пользователя базы; в удалённом режиме вопросы уходят во внешний сервис модели.
Настройка клиентов
{
"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.
XERJ
Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.
MCP Toolbox for Databases
MCP Toolbox for Databases от Google подключает агента к вашим базам данных.
kubeshark
Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.