KingdeeMCP — MCP-сервер для ERP Kingdee Cloud Star
KingdeeMCP
Сторонний MCP-сервер дает ассистенту 101 инструмент для ERP Kingdee Cloud Star: закупки, продажи, склад, финансы и вложения
- 138 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Инструменты создают, утверждают и удаляют документы ERP с правами указанного пользователя
- В конфигурации лежат логин и пароль к рабочей учетной записи
- Бизнес-данные закупок, продаж и финансов уходят в модель
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/kingdeemcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструменты создают, утверждают и удаляют документы ERP с правами указанного пользователя
- В конфигурации лежат логин и пароль к рабочей учетной записи
- Бизнес-данные закупок, продаж и финансов уходят в модель
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает Claude, Cursor, Windsurf, Cline и другие клиенты MCP к ERP Kingdee Cloud Star (金蝶云星空). Ассистент выполняет запросы на естественном языке: найти утвержденные закупочные заказы за месяц, создать заказ продавца, провести складские документы, выгрузить остатки. 101 инструмент разбит на 17 областей: производство, затраты, активы, аудит, закупки, продажи, склад, вложения к документам, финансы, внешняя переработка и отчеты. Универсальные инструменты работают с любым документом: сохранить, подать, утвердить, снять утверждение, удалить, протолкнуть вниз по цепочке. Динамические запросы к метаданным подсказывают поля формы, чтобы ассистент не гадал. Есть четыре инструмента для чтения структуры базы SQL Server. Сервер запускается через `uvx kingdee-mcp` в режиме stdio, а также по SSE и Streamable HTTP, есть образ Docker.
Для кого. Внедренцам и разработчикам на Kingdee Cloud Star, которые проверяют настройки и данные ERP разговором, и сотрудникам, которым нужны быстрые справки по документам.
Подходит, если
- На внедрении нужно быстро сверить статусы документов и остатки, не открывая меню ERP
- Показываете заказчику систему вживую: «покажи закупочные заказы» и ответ приходит сразу
- Надо разобраться со структурой формы и полями перед написанием своего интеграционного кода
- Пачку документов нужно подать на утверждение или утвердить, не нажимая каждый вручную
Не подходит, если
- У вас другая ERP: сервер работает только с Kingdee Cloud Star
- Продуктивная база и права пользователя неясны, а инструменты умеют удалять и утверждать документы
- Нужна официальная интеграция от вендора: проект сторонний и с Kingdee не связан
Пример запроса к агенту
Покажи проведенные закупочные заказы за этот месяц с суммами и поставщиками и отметь те, где склад еще не получил товар.MCP
- Транспорт
- stdio, sse, http
- Авторизация
- API-ключ
Переменные окружения
KINGDEE_SERVER_URLобязательная- Адрес сервера Kingdee с `/k3cloud/` на конце.
KINGDEE_ACCT_IDобязательная- Идентификатор учетной базы.
KINGDEE_USERNAMEобязательная- Логин интеграционной учетной записи.
KINGDEE_PASSWORDобязательная, секрет- Пароль этой учетной записи.
Ограничения
Проект сторонний, с компанией Kingdee не связан и ею не одобрен. Вход идет по логину и паролю пользователя (ValidateUser), действует набор прав этого пользователя, поэтому автор советует заводить отдельную интеграционную учетную запись, не Administrator. Нужны адрес сервера с `/k3cloud/`, идентификатор учетной базы, логин и пароль.
Инструменты чтения SQL Server требуют драйвера ODBC и лучше работают с учеткой только на чтение. Документация и сообщения на китайском. Последний коммит сделан в октябре 2026 года.
Как отключить. Удалите сервер kingdee из конфигурации клиента, остановите контейнер, если он запущен, и отзовите или смените пароль интеграционной учетной записи в Kingdee.
Частые вопросы
Как проверить, что настройки подключения верны?
Запустите образ с флагом `--check`: `docker run --rm --env-file .env ghcr.io/wahailong/kingdeemcp:latest --check`. Команда один раз входит в Kingdee и не поднимает сервер.
Какие переменные окружения нужны?
Четыре: `KINGDEE_SERVER_URL`, `KINGDEE_ACCT_ID`, `KINGDEE_USERNAME` и `KINGDEE_PASSWORD`. Для зондирования базы добавляются `MCP_SQLSERVER_HOST`, `MCP_SQLSERVER_DATABASE`, `MCP_SQLSERVER_USER` и `MCP_SQLSERVER_PASSWORD`.
Можно ли запустить сервер удаленно?
Да, `uvx kingdee-mcp --transport sse` или `--transport streamable-http` с параметрами `--host` и `--port`. Логин и пароль Kingdee и в этом режиме задаются переменными окружения.
Опасно ли давать ему права Administrator?
Автор советует так не делать и создать отдельную учетную запись. Сервер действует с правами этого пользователя, а среди инструментов есть удаление и утверждение документов.
Чем отличается вход по паролю от входа по AppID?
Вход по логину и паролю (ValidateUser) выполняет запросы от имени реального пользователя и учитывает его права и ограничения данных, а сторонний вход по AppID и AppSecret их не учитывает. Поэтому в текущей версии переменных `KINGDEE_APP_ID` и `KINGDEE_APP_SEC` больше нет.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер Apideck: агент работает с более чем 200 бизнес-системами: бухгалтерией, HRIS, CRM и файлами через единый API
MCP-сервер для управления FreeCAD из Claude Desktop и других клиентов: создание и правка моделей, запуск скриптов и FEM-анализ
MCP для СДЭК: калькулятор и HTTP-сервер
CDEK MCP Server
MCP-сервер для API СДЭК с калькулятором доставки по всем тарифам, заказом курьера и HTTP-режимом для внешних агентских платформ
MCP-сервер Power Platform: 312 инструментов для потоков, приложений, Dataverse и Power Pages, управление обычными словами.
Официальный MCP-сервер Cybozu: агент читает и меняет приложения, записи и пространства kintone через REST API.
MCP-сервер для управления Windows: агент открывает приложения, кликает и печатает, читает состояние окон и интерфейса, работает с файлами и PowerShell
Коротко о README
README объясняет, зачем нужен сервер на внедрении и в повседневной работе, перечисляет клиентов, дает установку через `uvx` и `pip`, режимы SSE и HTTP, Docker и таблицу переменных. В конце описаны 101 инструмент по группам и переход от AppID к паролю.