Rakuten Mcp

Name: Rakuten Mcp
Author: mrslbt

@mrslbt

关于 Rakuten Mcp

MCP server for the Rakuten Web Service API. 28 read-only tools across Ichiba (e-commerce), Books, Travel, Recipe, Kobo, and GORA (golf). Bilingual EN/JA tool descriptions.

#mcp #rakuten #japan #ecommerce #ai-agents #shopping #hotels #books

基本信息

分类

其他

许可证

MIT

运行时

node

传输方式

stdio

发布者

mrslbt

提交者

Marsel Bait

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "rakuten": {
      "command": "npx",
      "args": [
        "rakuten-mcp"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Rakuten Mcp?

The Rakuten Mcp server is a Model Context Protocol (MCP) server for the Rakuten Web Service API. It exposes 28 read-only tools across six Rakuten product families: Ichiba (marketplace), Books, Travel, Recipe, Kobo, and GORA (golf). Every tool description is available in English and Japanese. It is designed for developers who want to integrate Rakuten data—product search, hotel availability, recipe rankings, and more—into MCP-compatible clients like Claude Desktop, Claude Code, Cursor, and others.

How to use Rakuten Mcp?

Install the package globally with npm install -g rakuten-mcp or run on demand with npx rakuten-mcp. You must set the environment variables RAKUTEN_APP_ID and RAKUTEN_ACCESS_KEY, obtained from the Rakuten Web Service developer portal. Optionally, set RAKUTEN_AFFILIATE_ID to append affiliate codes to returned URLs and RAKUTEN_MAX_RETRIES (default 3). Add the server to your MCP client’s configuration (e.g., claude_desktop_config.json) using the command npx -y rakuten-mcp and the required environment variables.

Key features of Rakuten Mcp

28 read-only tools across six Rakuten API families
Dual‑language tool descriptions (English and Japanese)
All endpoints verified against the live Rakuten API
Supports both stdio and HTTP transport
Automatic retry with backoff on 429 and 5xx errors
Typed error tree with eight error classes
Modular architecture: one file per API family

Use cases of Rakuten Mcp

Search Rakuten Ichiba for products with price filters, genre restrictions, and rankings
Browse and search Rakuten Books (books, CDs, DVDs, games, software, magazines)
Find hotels with room availability and pricing for specific dates via Rakuten Travel
Get popular recipes from Rakuten Recipe with ingredient lists, prep time, and cost estimate
Search Rakuten Kobo eBooks and navigate the Kobo genre tree
Discover golf courses and reservation plans on Rakuten GORA

FAQ from Rakuten Mcp

What credentials are needed to use Rakuten Mcp?

You must obtain a Rakuten Application ID (UUID format) and an Access Key (starts with pk_) from the Rakuten Web Service developer portal. These are set as environment variables RAKUTEN_APP_ID and RAKUTEN_ACCESS_KEY.