mcp-cn-commerce — MCP-сервер для Claude Code: запуск и функции
MCP-сервер для чтения операционных данных на китайских маркетплейсах через stdio. Позволяет агенту собирать отчёты по заказам, возвратам и остаткам.
claude mcp add --env OCEANENGINE_ACCESS_TOKEN=<OCEANENGINE_ACCESS_TOKEN> --env DOUDIAN_APP_KEY=<DOUDIAN_APP_KEY> --env DOUDIAN_APP_SECRET=<DOUDIAN_APP_SECRET> --env DOUDIAN_SHOP_ID=<DOUDIAN_SHOP_ID> --env DOUDIAN_ACCESS_TOKEN=<DOUDIAN_ACCESS_TOKEN> --transport stdio mcp-cn-commerce -- uvx mcp-cn-commerceЧто делает mcp-cn-commerce
Сервер предоставляет набор адаптеров для китайских торговых площадок вроде Doudian, Taobao, JD и рекламного кабинета Ocean Engine. Все операции работают исключительно в режиме чтения. Никаких правок в карточки товаров агент не вносит. Задача сервера — отдавать структурированные выгрузки по продажам, балансам и сервисным обращениям.
Кодовая база рассчитана на Python 3.11+ и связывается с клиентами по протоколу stdio. В ядре есть общий пул сетевых соединений и маскирование персональных сведений. Суммы и временные метки приводятся к единому формату. Пропуски в пагинации сервер сразу помечает в сводке.
Для запуска понадобятся ключи доступа и токены авторизации от API выбранных площадок. Операции чтения для Pinduoduo отключены из-за отсутствия официальной схемы данных. Все адаптеры в коде имеют флаг live_verified: false. Сверка на реальных магазинах ещё не проводилась.
Какие задачи решает
- читать списки заказов и данные возвратов на Doudian и JD
- проверять баланс рекламного счёта в Ocean Engine
- получать выгрузки по операциям магазина в Taobao без права записи
- нормализовать финансовые суммы и даты из разных маркетплейсов в отчётах
Примеры запросов агенту
- Проверь баланс аккаунта в Ocean Engine и выведи остаток.
- Запроси список свежих заказов из магазина Doudian за сегодня.
- Собери отчёт по возвратам в JD и найди незакрытые заявки.
Как установить mcp-cn-commerce
Командой платформы
claude mcp add --env OCEANENGINE_ACCESS_TOKEN=<OCEANENGINE_ACCESS_TOKEN> --env DOUDIAN_APP_KEY=<DOUDIAN_APP_KEY> --env DOUDIAN_APP_SECRET=<DOUDIAN_APP_SECRET> --env DOUDIAN_SHOP_ID=<DOUDIAN_SHOP_ID> --env DOUDIAN_ACCESS_TOKEN=<DOUDIAN_ACCESS_TOKEN> --transport stdio mcp-cn-commerce -- uvx mcp-cn-commerceВместо <…> подставьте свои значения. Ещё 20 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-cn-commerce <команда>
Командой платформы
codex mcp add mcp-cn-commerce --env OCEANENGINE_ACCESS_TOKEN=<OCEANENGINE_ACCESS_TOKEN> --env DOUDIAN_APP_KEY=<DOUDIAN_APP_KEY> --env DOUDIAN_APP_SECRET=<DOUDIAN_APP_SECRET> --env DOUDIAN_SHOP_ID=<DOUDIAN_SHOP_ID> --env DOUDIAN_ACCESS_TOKEN=<DOUDIAN_ACCESS_TOKEN> -- uvx mcp-cn-commerceВместо <…> подставьте свои значения. Ещё 20 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-cn-commerce <команда>
Файл настроек
{
"mcpServers": {
"mcp-cn-commerce": {
"command": "uvx",
"args": [
"mcp-cn-commerce"
],
"env": {
"OCEANENGINE_ACCESS_TOKEN": "<OCEANENGINE_ACCESS_TOKEN>",
"DOUDIAN_APP_KEY": "<DOUDIAN_APP_KEY>",
"DOUDIAN_APP_SECRET": "<DOUDIAN_APP_SECRET>",
"DOUDIAN_SHOP_ID": "<DOUDIAN_SHOP_ID>",
"DOUDIAN_ACCESS_TOKEN": "<DOUDIAN_ACCESS_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 20 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-cn-commerce <команда>
Файл настроек
{
"servers": {
"mcp-cn-commerce": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-cn-commerce"
],
"env": {
"OCEANENGINE_ACCESS_TOKEN": "<OCEANENGINE_ACCESS_TOKEN>",
"DOUDIAN_APP_KEY": "<DOUDIAN_APP_KEY>",
"DOUDIAN_APP_SECRET": "<DOUDIAN_APP_SECRET>",
"DOUDIAN_SHOP_ID": "<DOUDIAN_SHOP_ID>",
"DOUDIAN_ACCESS_TOKEN": "<DOUDIAN_ACCESS_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 20 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-cn-commerce <команда>
Командой платформы
gemini mcp add -e OCEANENGINE_ACCESS_TOKEN=<OCEANENGINE_ACCESS_TOKEN> -e DOUDIAN_APP_KEY=<DOUDIAN_APP_KEY> -e DOUDIAN_APP_SECRET=<DOUDIAN_APP_SECRET> -e DOUDIAN_SHOP_ID=<DOUDIAN_SHOP_ID> -e DOUDIAN_ACCESS_TOKEN=<DOUDIAN_ACCESS_TOKEN> mcp-cn-commerce uvx mcp-cn-commerceВместо <…> подставьте свои значения. Ещё 20 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-cn-commerce <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-cn-commerce
Как установить mcp-cn-commerce в Claude Code?
Выполните команду `claude mcp add --env OCEANENGINE_ACCESS_TOKEN=<OCEANENGINE_ACCESS_TOKEN> --env DOUDIAN_APP_KEY=<DOUDIAN_APP_KEY> --env DOUDIAN_APP_SECRET=<DOUDIAN_APP_SECRET> --env DOUDIAN_SHOP_ID=<DOUDIAN_SHOP_ID> --env DOUDIAN_ACCESS_TOKEN=<DOUDIAN_ACCESS_TOKEN> --transport stdio mcp-cn-commerce -- uvx mcp-cn-commerce`.
Что делает mcp-cn-commerce?
Предоставляет ИИ-агентам доступ к операционным данным продавца на китайских торговых платформах. Все инструменты работают строго в режиме чтения.
Какие требования нужны для запуска сервера?
Требуется интерпретатор Python версии 3.11 или выше, а также действующие API-ключи и токены авторизации от нужных площадок.
