Skip to main content
Glama

rms-mcp

MCP-сервер для Rakuten RMS API — Панель управления продажами и заказами

Возможности

Получение данных Rakuten RMS из Claude Code (или любого другого MCP-клиента):

Инструмент

Описание

rms_daily_sales

Ежедневная сводка продаж (количество, налоги, купоны, доставка)

rms_product_ranking

Рейтинг товаров (количество, продажи, средняя цена)

rms_order_detail

Полные детали заказа в формате JSON по номеру заказа

rms_cancel_rate

Уровень отмен и количество отмененных заказов

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 tools
rms_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

    A3.5/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables searching and retrieving information from Rakuten services (Ichiba, Books, Travel, Recipe, Kobo, GORA) via the new API endpoints with secure authentication.
      1
      MIT
    • F
      license
      A
      quality
      C
      maintenance
      Enables 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
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      1
      MIT