tabedata-mcp

Model Context Protocol server for Japanese food nutrition data. Bilingual JP/EN lookups across konbini, restaurant chains, and grocery brands. Macros, allergens, sodium, and menu navigation for any AI assistant operating in Japan.

460 sourced items across 21 chains. 42 come from Japan's MEXT food composition database (36 generic staples + 6 drinks); the rest are transcribed from official manufacturer labels and restaurant nutrition PDFs, with ~10% flagged as estimates where official figures weren't available. Size variants (並 / 大盛 / 特盛) on every restaurant chain that publishes them.

Who this is for

• Tracking macros, sodium, or carbs on a Japanese diet
• Looking up allergens on a menu you can't read
• Travelers using an AI assistant to navigate Japanese restaurants and konbini
• Comparing options across chains ("which chain has the leanest chicken?")
• Building nutrition or meal apps that need real Japanese product data

Install

npm install -g tabedata-mcp

Or run on demand with npx -y tabedata-mcp.

Configuration

No API keys needed. Curated database ships with the package.

Variable	Required	Description
MCP_TRANSPORT	no	stdio (default) or http.
MCP_AUTH_TOKEN	http only	Bearer token. HTTP transport refuses to start without it.
MCP_HTTP_PORT	no	Default 8787.
MCP_HTTP_HOST	no	Default 127.0.0.1.
MCP_HTTP_ALLOWED_ORIGINS	no	Comma-separated CORS allowlist for HTTP transport.

Claude Desktop

Edit claude_desktop_config.json:

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

Claude Code

claude mcp add tabedata -- npx -y tabedata-mcp

Cursor / Windsurf

Add to ~/.cursor/mcp.json with the same shape as Claude Desktop.

Tools

Tool	Description
search_food	Bilingual fuzzy search across the dataset. Accepts JP or EN queries (e.g. salad chicken or サラダチキン).
konbini_item	Chain-scoped lookup for 7-Eleven, Lawson, FamilyMart, Ministop. Includes allergens and ingredient lists where available.
restaurant_meal	Chain meal lookup with size variants (並 / 大盛 / 特盛) and allergen tags.
analyze_meal	Natural-language meal analyzer. Recognizes counts, weights (200g rice), fractions (half avocado), and restaurant size names (Nakau large oyakodon). Returns macro totals plus optional comparison to personalized targets.
find_alternatives	Swap an item for a better one along a chosen axis (higher protein, lower calorie, lower sodium). Returns each alternative with its improvement and tradeoff.
daily_targets	Mifflin-St Jeor BMR x activity multiplier x goal-driven deficit/surplus. Diabetes risk shifts the macro split. Hypertension surfaces a sodium guidance note.

Prompts

Prompt	What it does
plan_my_day	Given a goal (e.g. "cut to 70kg, hit 150g protein"), chains daily_targets → meal proposal → analyze_meal → find_alternatives into one guided workflow.

Coverage

Konbini (122 items)

Chain	Items
7-Eleven	46
Lawson	34
FamilyMart	29
Ministop	13

Restaurant chains (272 items)

Japanese chains: Nakau, Sukiya, Yoshinoya, Matsuya, CoCo Ichibanya, Marugame Seimen, Tenya, MOS Burger, Yayoiken, Ootoya, Ichiran.

Western and global chains: McDonald's Japan, KFC Japan, Subway Japan, Lotteria, Freshness Burger, Doutor.

Generic, drink, and brand items (

... View full README on GitHub