rms-mcp

Servidor MCP para la API de Rakuten RMS — Panel de ventas y gestión de pedidos

Funcionalidades

Obtención de datos de Rakuten RMS desde Claude Code (o cualquier cliente MCP):

Related MCP server: mcp-estat-japan

Configuración

git clone https://github.com/yasuhidekoizumi-afk/rms-mcp.git
cd rms-mcp
uv sync

Autenticación

Emita serviceSecret y licenseKey desde la pantalla de gestión de RMS → Configuración de API.

export RMS_SERVICE_SECRET="SP404839_xxxxxxxxxx"
export RMS_LICENSE_KEY="SL404839_xxxxxxxxxx"

Verificación de funcionamiento

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()
"

Configuración de 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"
      }
    }
  }
}

Referencia rápida

• Ventas diarias: Muéstrame las ventas de Rakuten de hoy → rms_daily_sales

• Ranking de productos: ¿Cuál es el TOP 10 de Rakuten de este mes? → rms_product_ranking(top_n=10)

• Tasa de cancelación: ¿Cuál es la tasa de cancelación de este mes? → rms_cancel_rate

• Detalles de pedido: Detalles de este pedido → rms_order_detail(order_numbers=[...])

Cobertura de API

• [x] RakutenPayOrderAPI (searchOrder, getOrder)

• [x] PurchaseItemAPI (searchOrderItem)

• [ ] InventoryAPI

• [ ] ProductAPI

• [ ] CouponAPI

📖 Manual de introducción

Consulte SETUP.md para obtener instrucciones detalladas de instalación.

Licencia

MIT — ORYZAE Inc.