rms-mcp
rms-mcp
MCP-сервер для Rakuten RMS API — Панель управления продажами и заказами
Возможности
Получение данных Rakuten RMS из Claude Code (или любого другого MCP-клиента):
Инструмент | Описание |
| Ежедневная сводка продаж (количество, налоги, купоны, доставка) |
| Рейтинг товаров (количество, продажи, средняя цена) |
| Полные детали заказа в формате JSON по номеру заказа |
| Уровень отмен и количество отмененных заказов |
Related MCP server: Amazon Orders MCP
Настройка
git clone https://github.com/yasuhidekoizumi-afk/rms-mcp.git
cd rms-mcp
uv syncАутентификация
Выпустите serviceSecret и licenseKey в панели управления RMS → Настройки API.
export RMS_SERVICE_SECRET="SP404839_xxxxxxxxxx"
export RMS_LICENSE_KEY="SL404839_xxxxxxxxxx"Проверка работы
RMS_SERVICE_SECRET="..." RMS_LICENSE_KEY="..." uv run python -c "
from rms_mcp.order_api import OrderAPI
from rms_mcp.client import RMSClient
c = RMSClient('SP...', 'SL...')
api = OrderAPI(c)
r = api.search_orders('2026-05-01T00:00:00+0900','2026-05-08T23:59:59+0900')
print(len(r.get('orderNumberList',[])), '件')
c.close()
"Настройка Claude Code
.mcp.json:
{
"mcpServers": {
"rms-mcp": {
"command": "uv",
"args": ["run", "rms-mcp"],
"cwd": "/path/to/rms-mcp",
"env": {
"RMS_SERVICE_SECRET": "SP404839_xxx",
"RMS_LICENSE_KEY": "SL404839_xxx"
}
}
}
}Краткий справочник
Продажи за день:
Покажи сегодняшние продажи на Rakuten→rms_daily_salesРейтинг товаров:
Какой топ-10 на Rakuten в этом месяце?→rms_product_ranking(top_n=10)Уровень отмен:
Какой уровень отмен в этом месяце?→rms_cancel_rateДетали заказа:
Детали этого заказа→rms_order_detail(order_numbers=[...])
Покрытие API
[x] RakutenPayOrderAPI (searchOrder, getOrder)
[x] PurchaseItemAPI (searchOrderItem)
[ ] InventoryAPI
[ ] ProductAPI
[ ] CouponAPI
📖 Руководство по установке
Подробные инструкции по установке см. в SETUP.md.
Лицензия
MIT — ORYZAE Inc.
Available Tools
4 toolsrms_cancel_rateC
Cancellation rate and counts
Inputs: start_date, end_date.
rms_daily_salesB
Daily sales summary (orders, revenue, tax, coupons, delivery)
Inputs: start_date, end_date.
rms_order_detailC
Full order detail by order number(s)
Inputs: order_numbers (required).
rms_product_rankingC
Product sales ranking by revenue (from PackageModelList)
Inputs: start_date, end_date, top_n.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct aspect of RMS data: cancellation rates, daily sales, order details, and product rankings. There is no overlap in functionality, making it easy for an agent to select the correct tool.
All tools follow a consistent pattern: 'rms_' prefix followed by a descriptive noun phrase using underscores (cancel_rate, daily_sales, order_detail, product_ranking). This predictability aids both human and agent understanding.
With 4 tools, this server is well-scoped for a focused analytics/reporting domain. Each tool serves a clear purpose without unnecessary bloat, and the count fits comfortably within the optimal range of 3-15 tools.
The tool set covers key reporting and analytics needs for an RMS: cancellation, sales summary, order details, and product ranking. Minor gaps exist, such as the absence of time-range filtering or trend comparisons, but the core query functionality is present.
Maintenance
Related MCP Connectors
Products, customers, orders, subscriptions, benefits, revenue metrics and refunds.
Read-only Amazon seller analytics: sales, Buy Box, FBA inventory, alerts, revenue and fees.
Read your Cakto sales: orders, revenue analytics, subscriptions, churn, customers and products.
Read-only zobrx e-commerce data: P&L, orders, inventory, marketplace, tax & shelf insights.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables searching and retrieving information from Rakuten services (Ichiba, Books, Travel, Recipe, Kobo, GORA) via the new API endpoints with secure authentication.1MIT
- FlicenseAqualityCmaintenanceEnables importing and querying historical Amazon consumer order data from multiple accounts, with tools for syncing orders, retrieving filtered order details, and managing account sessions.5-
- AlicenseNot gradedqualityDmaintenanceEnables read-only access to retail ERP data through the official output WebService, letting users query products, stock and inventory, customers and suppliers, sales movement and billing, orders, salespeople, and store information with date-window and store filters.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables merchants to generate charts and read-only insights from their food-delivery store inside AI assistant chats, covering sales, payouts, average ticket, fees, menu mix, and ratings through the official API.1MIT