[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_103":104},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@haomingkoo/japan-seasons-mcp' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":48,"_78":-5,"_79":57,"_80":81,"_82":83,"_84":85,"_86":87,"_88":89,"_90":91},"apiUrl","https://odel.app/api","creator","haomingkoo","moduleId","japan-seasons-mcp","@haomingkoo/japan-seasons-mcp","displayName","japan seasons mcp","tagline","Live Japan seasonal travel MCP: sakura, koyo, flowers, festivals, fruit farms, and weather.","iconKey","https://avatars.githubusercontent.com/u/206514831?v=4","category","dev-tools","status","published","metaDescription","metaKeywords","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://seasons.kooexperience.com/mcp?dateStyle={dateStyle}&temperatureUnit={temperatureUnit}&includeCoordinates={includeCoordinates}&mapLanguage={mapLanguage}\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363440000,"updatedAt",1781499666000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.haomingkoo%2Fjapan-seasons","sourceVerified",true,"importedAt","upstreamStars",0,"upstreamUpdatedAt",1780874851000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/haomingkoo/japan-seasons-mcp","githubRepoFullName","haomingkoo/japan-seasons-mcp","releaseId","ext-haomingkoo-japan-seasons-mcp","version","0.4.16","descriptionMarkdown","

\n\n# 🌸 japan-seasons-mcp\n\n**Give your AI assistant live Japan travel data — cherry blossom forecasts, autumn leaves, fruit picking, flowers, festivals & more.**\n\n*1,700+ spots. 17 tools. Live data from Japan Meteorological Corporation.*\n\n[![npm version](https://img.shields.io/npm/v/japan-seasons-mcp.svg)](https://www.npmjs.com/package/japan-seasons-mcp)\n[![npm downloads](https://img.shields.io/npm/dm/japan-seasons-mcp.svg)](https://www.npmjs.com/package/japan-seasons-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)\n[![MCP](https://img.shields.io/badge/MCP-compatible-blueviolet.svg)](#use-it-with-ai-assistants)\n[![Live demo](https://img.shields.io/badge/demo-live-brightgreen.svg)](https://seasons.kooexperience.com)\n[![japan-seasons-mcp MCP server](https://glama.ai/mcp/servers/haomingkoo/japan-seasons-mcp/badges/score.svg)](https://glama.ai/mcp/servers/haomingkoo/japan-seasons-mcp)\n[![smithery badge](https://smithery.ai/badge/haomingkoo/japan-seasons-mcp)](https://smithery.ai/server/haomingkoo/japan-seasons-mcp)\n\n[**Live map**](https://seasons.kooexperience.com) · [**Hosted MCP endpoint**](https://seasons.kooexperience.com/mcp) · [**npm**](https://www.npmjs.com/package/japan-seasons-mcp)\n\n

\n\n---\n\n## Screenshots\n\n| Cherry blossom map | Spot detail & weather |\n|---|---|\n|

|\n\n| Fruit picking | What's On in Japan |\n|---|---|\n|

|\n\n| Flowers in season | Mobile |\n|---|---|\n|

|\n\n---\n\n## The problem\n\nYou ask Claude, ChatGPT, or Gemini: *\"When should I visit Kyoto for cherry blossoms?\"*\n\nYou get \"late March to early April\" — the same answer every year, based on training data that has no idea what this winter was like.\n\nThe actual bloom date shifts by 2–3 weeks depending on temperatures. Tokyo peaked March 29 in 2024, March 22 in 2023, March 28 in 2022 — a 7-day spread in just two years. Your AI is guessing. This MCP server stops the guessing.\n\n## The fix\n\nIt connects Claude (or any MCP client) to live forecast data from the Japan Meteorological Corporation — the same data that powers SAKURA NAVI and Japan's major cherry blossom forecast sites. Bloom meters update daily at 9 AM JST; spot observations update when JMC reporters file.\n\n```\nYou: \"I'm in Japan April 8–14. Where should I see cherry blossoms?\"\n\nClaude: Based on today's JMC forecast data:\n\n Cities in full bloom during your visit:\n • Sendai (Miyagi) — full bloom forecast Apr 10 (avg Apr 12)\n • Morioka (Iwate) — full bloom forecast Apr 13 (avg Apr 16, running early)\n • Akita — full bloom forecast Apr 14\n\n For Sendai, top spots include Tsutsujigaoka Park (92% full bloom today)\n and Nishi Park. Morioka Castle ruins are a classic.\n\n One thing to watch: 40% rain chance Apr 10 in Sendai. Rain speeds up\n petal fall, so Apr 11–12 is probably the safer window.\n```\n\nReal bloom percentages. Real park names. Real weather.\n\n---\n\n## Use it with AI assistants\n\nThere are two different ways an AI assistant can use Japan in Seasons:\n\n1. **AI search / web browsing** can find and cite the public pages, text summaries, and JSON APIs. This is the lowest-friction path for people asking \"latest sakura dates\" in ChatGPT, Perplexity, Google AI Mode, etc.\n2. **MCP tool use** only works after the user or workspace admin connects the MCP server inside an MCP-capable client. Finding this repo in search does not give the assistant permission to run MCP tools.\n\nFor AI search, use these crawlable sources:\n\n- Latest sakura text summary: `https://seasons.kooexperience.com/sakura-forecast.txt`\n- Sakura forecast JSON: `https://seasons.kooexperience.com/api/sakura/forecast`\n- Interactive map and forecast pages: `https://seasons.kooexperience.com`\n\n### Remote MCP endpoint\n\nNo package install is needed when the client supports remote/streamable HTTP MCP. Add this as the MCP server/app/connector URL:\n\n```text\nhttps://seasons.kooexperience.com/mcp\n```\n\nFor ChatGPT Apps/Connectors, use:\n\n- **Name:** `Japan in Seasons`\n- **Description:** `Use this for live Japan seasonal travel data: cherry blossom and sakura dates, autumn leaves, flowers, festivals, fruit picking, and weather. Best for current or date-specific Japan travel questions.`\n- **Connector URL:** `https://seasons.kooexperience.com/mcp`\n\n### Claude Desktop / Claude Code / stdio MCP clients\n\nAdd this to the client's MCP config:\n\n```json\n{\n \"mcpServers\": {\n \"japan-seasons\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"japan-seasons-mcp\"]\n }\n }\n}\n```\n\nOptional connection preferences supported by the hosted endpoint:\n\n- `dateStyle` — `friendly` or `iso`\n- `temperatureUnit` — `celsius` or `fahrenheit`\n- `includeCoordinates` — `true` or `false`\n- `mapLanguage` — `english` or `japanese`\n\n### Self-host\n\n```bash\nPORT=3000 npx -y japan-seasons-mcp --http\n# MCP endpoint: http://localhost:3000/mcp\n```\n\nOptional durable cache for the hosted web map:\n\n```bash\nJAPAN_SEASONS_CACHE_DIR=/data PORT=3000 npx -y japan-seasons-mcp --http\n```\n\nPoint `JAPAN_SEASONS_CACHE_DIR` at a persistent volume, for example a Railway Volume mounted at `/data`. This stores the warmed national sakura/koyo all-spots JSON across restarts; without it, the app falls back to in-memory cache and still works.\n\n### Why ChatGPT may find it but refuse to use it\n\nChatGPT Search can discover `japan-seasons-mcp` as a web result, but web discovery is not the same as connecting an MCP server. If the chat only has web search enabled, it should cite the crawlable forecast pages or JSON API. To run tools like `sakura_now`, `sakura_forecast`, or `sakura_spots`, the MCP endpoint must first be added as a ChatGPT app/connector or configured in another MCP client.\n\n---\n\n## What's covered\n\n| Season | Data | Spots | Source |\n|--------|------|-------|--------|\n| Jan–Feb | Kawazu cherry (early deep-pink variety, Izu Peninsula) | 9 spots | JMC live |\n| Jan–Mar | Plum blossoms | 8 spots | curated |\n| Mar–May | Cherry blossom (sakura) | **1,012 parks & temples** | JMC live, daily |\n| Apr–May | Wisteria | 13 spots | curated |\n| May–Jun | Iris gardens | 9 spots | curated |\n| Jun–Jul | Hydrangea | 15 spots | curated |\n| Jun–Jul | Lavender fields | 6 spots | curated |\n| Jul–Aug | Fireworks festivals & summer matsuri | 46 events | curated |\n| Jul–Aug | Sunflower fields | 7 spots | curated |\n| May–Nov | Fruit picking | **346 farms**, 14 fruits | Jalan + Navitime |\n| Sep–Oct | Cosmos fields | 8 spots | curated |\n| Oct–Dec | Autumn leaves (koyo) | **687 viewing spots** | JMC live |\n| Jan–Feb | Winter events (Sapporo Snow Festival, etc.) | 8 events | curated |\n\n1,700+ GPS-tagged spots across 12 seasonal categories.\n\n---\n\n## Tools\n\n### Best first-call tools\n\n**`japan_seasonal_answer`** — answer a broad traveler question\n\nUse this when someone asks a normal question instead of naming a dataset: \"How is the sakura forecast?\", \"What is good in Japan in June?\", \"Where should I see autumn leaves in late November?\", or \"What seasonal activities match my dates?\" It routes to the right live or curated dataset and returns a ready-to-use recommendation.\n\n**`sakura_now`** — current cherry blossom answer\n\nThe best first call for broad sakura prompts. It summarizes what is good now, what is coming next, or what matched the user's trip dates, using live JMC forecast/observation data, and includes a short list of specific viewing spots when spot data is available.\n\n**`koyo_now`** — current autumn leaves answer\n\nThe autumn equivalent of `sakura_now`: current koyo timing, maple/ginkgo peaks, trip-date matches, and next-step guidance for exact spots.\n\n**`search` / `fetch`** — retrieval-friendly access\n\nProvider-friendly search/fetch tools for ChatGPT-style retrieval and deep-research citation flows. `search` returns result IDs; `fetch` returns full text with a canonical URL.\n\n### Cherry blossom\n\n**`sakura_forecast`** — the big picture\n\nAll 48 JMA observation cities in one call: this year's forecast, actual dates when observed, and how each city compares to the historical average. Good starting point before you drill into specific spots.\n\n```\n\"What's the cherry blossom situation in Japan right now?\"\n→ 48 cities by region, bloom status, forecast dates, days vs average\n```\n\n**`sakura_spots`** — specific parks and temples\n\n1,012 spots across Japan with current status, bloom percentages, and GPS coordinates. When JMC spot reporters have filed a recent update (within 48 hours), the tool uses that observed status as the primary reading. Otherwise it falls back to the JMC bloom-meter forecast. Stale observations are shown as context, not hidden.\n\n```\n\"Cherry blossom spots in Kyoto\"\n→ 51 spots: Kiyomizu-dera (Full bloom, observed Apr 9), Maruyama Park (91% full-bloom)...\n```\n\n**`sakura_best_dates`** — match travel dates to bloom\n\nGive it your start and end dates, get back the cities where full bloom overlaps your window plus a short list of specific viewing spots when spot data is available.\n\n```\n\"I'm in Japan April 8–14, where should I go?\"\n→ Cities with bloom in that window, ranked by timing, plus spot suggestions and map links\n```\n\n**`kawazu_forecast`** — early-season deep-pink variety\n\nKawazu cherry blooms January–February in Izu Peninsula, months before standard sakura opens anywhere.\n\n```\n\"Can I see cherry blossoms in February?\"\n→ 9 Kawazu spots with bloom %, GPS, forecast dates\n```\n\n---\n\n### Autumn leaves\n\n**`koyo_forecast`** — maple and ginkgo timing by city\n\n50+ cities with this year's colour-change dates and how they compare to the historical normal. Maple and ginkgo peak at different times; both are included.\n\n```\n\"When do autumn leaves peak in Kyoto vs Hokkaido?\"\n→ City-by-city maple/ginkgo dates, days early or late vs average\n```\n\n**`koyo_best_dates`** — same idea as sakura best dates, for autumn\n\nMatch your travel window to cities in peak colour.\n\n```\n\"I'm in Japan late October, where for autumn leaves?\"\n→ Cities in peak colour during your dates, maple vs ginkgo timing\n```\n\n**`koyo_spots`** — 687 viewing spots by prefecture\n\nEach spot has a peak window (start, peak, end), leaf type, popularity rating, and GPS.\n\n```\n\"Top autumn leaves spots in Kyoto\"\n→ Arashiyama, Eikando, Tofukuji, Rurikoin... with star rating and exact peak dates\n```\n\n---\n\n### Flowers\n\n**`flowers_spots`** — 90 curated spots, 8 flower types, Jan through Oct\n\n| Type | Season | Notable spots |\n|------|---------|--------------|\n| Plum | Jan–Mar | Atami, Mito Kairakuen |\n| Nanohana | Feb–Apr | Chiba coast, Showa Kinen |\n| Wisteria | Apr–May | Ashikaga, Kawachi, Kameido Tenjin |\n| Iris | May–Jun | Meiji Jingu, Horikiri Shobuen |\n| Hydrangea | Jun–Jul | Meigetsu-in, Hasedera, Yatadera |\n| Lavender | Jun–Jul | Furano (Hokkaido) |\n| Sunflower | Jul–Aug | Zama, Hokuryu |\n| Cosmos | Sep–Oct | Showa Kinen, Hitachi Seaside |\n\nFilter by `type`, `prefecture`, or `month`. Each spot has an official URL and verified GPS.\n\n---\n\n### Festivals and events\n\n**`festivals_list`** — 46 major recurring events with official URLs and attendance figures\n\n```\n\"Best fireworks festivals in Japan?\"\n→ Sumida River (900k), Nagaoka (1.1M), Omagari, PL Osaka, Miyajima...\n\n\"Festivals in Kyoto in October?\"\n→ Jidai Matsuri (Oct 22), Kurama Fire Festival, with booking tips\n```\n\nFilter by `type` (fireworks / matsuri / winter), `month`, and `prefecture`.\n\n---\n\n### Fruit picking\n\n**`fruit_seasons`** — full-year calendar for 14 fruits\n\nWhich fruits are in season and at peak for any given month, with best regions and notes.\n\n```\n\"What fruit can I pick in September in Japan?\"\n→ Grape at peak (Yamanashi, Nagano), Pear at peak, Peach ending, Apple starting\n```\n\n**`fruit_farms`** — 346 farms with GPS and booking links\n\nPass `month=` and it auto-filters to farms with something in season. Add `region=` to narrow further.\n\n```\n\"Strawberry farms near Tokyo in April\"\n→ Farms in the Tokyo/Kanto area with strawberry in season, GPS + Jalan links\n```\n\n---\n\n### Weather\n\n**`weather_forecast`** — 3-day JMA forecast for 51 cities\n\nTemperature, rain probability by 6-hour window, and conditions. Worth checking because rain speeds up petal fall.\n\n```\n\"Weather in Osaka this weekend?\"\n→ Min/max temp, rain % per 6-hour window, conditions\n```\n\n---\n\n## Usage\n\nAsk your MCP client for a goal, not a tool name. A few good examples:\n\n```text\n\"I'm in Japan April 8-14. Where should I go for cherry blossoms?\"\n\"Top autumn leaves spots in Kyoto in late November\"\n\"What flowers are in season in Japan in June?\"\n\"Best fireworks festivals in Japan in August\"\n\"Fruit picking near Tokyo in May\"\n\"Will rain in Osaka this weekend make sakura worse?\"\n```\n\nTypical workflow:\n\n1. Ask for timing first with `sakura_best_dates`, `koyo_best_dates`, `sakura_forecast`, or `koyo_forecast`.\n2. Drill into exact parks, temples, farms, or events with `sakura_spots`, `koyo_spots`, `fruit_farms`, `flowers_spots`, or `festivals_list`.\n3. Check `weather_forecast` if rain or temperature could change the recommendation.\n4. Set optional connection preferences if you want ISO dates, Fahrenheit weather, Japanese map links, or outputs without GPS coordinates.\n\n---\n\n## How it works\n\n```mermaid\nflowchart LR\n subgraph live[\"Live APIs (cached 1–6h)\"]\n JMC[\"Japan Meteorological Corp\\nsakura · koyo · kawazu\\n1,700+ spots · daily 9AM JST\"]\n JMA[\"Japan Met Agency\\nweather · 51 cities\\nhourly\"]\n end\n\n subgraph static[\"Static datasets (loaded at startup)\"]\n DATA[\"flowers.json — 90 spots\\nfestivals.json — 46 events\\nfruit-farms.json — 346 farms\"]\n end\n\n subgraph server[\"japan-seasons-mcp\"]\n MCP[\"17 tools\\n2 prompts\\nstdio + HTTP transport\"]\n end\n\n subgraph clients[\"MCP clients\"]\n C1[\"Claude Desktop\\n/ Claude Code\"]\n C2[\"Cursor\\n/ Windsurf\"]\n C3[\"Any MCP\\nclient\"]\n end\n\n JMC -->|live fetch| MCP\n JMA -->|live fetch| MCP\n DATA -->|in-memory| MCP\n MCP -->|MCP protocol| C1\n MCP -->|MCP protocol| C2\n MCP -->|MCP protocol| C3\n```\n\nStatic datasets load at startup and are served from memory with no disk I/O per request. Live JMC data is cached server-side (1–6h TTL). The all-spots payload is pre-gzipped at startup so repeat serving is essentially free.\n\n---\n\n## Bloom scale reference\n\nJMC publishes two separate data products for sakura spots. Both are used:\n\n**Spot observations** — reported by JMC partners and spot managers, used as primary status when updated within 48 hours:\n\n```\nState 0 Pre-bloom (buds visible)\nState 1 First bloom — 開花 (a few flowers open)\nState 2 30% bloom — 三分咲き (sanbu-zaki)\nState 3 70% bloom — 七分咲き (nanabu-zaki)\nState 4 Full bloom — 満開 (mankai)\nState 5 Petals starting to fall — 散り始め\nState 6 Green leaves — 葉桜 (hazakura, bloom season over)\n```\n\n**Bloom-meter forecast** (jr_data) — mathematical model used as fallback when no fresh observation exists:\n\n```\nBLOOM RATE — progress toward first bloom (開花)\n─────────────────────────────────────────────────\n 0% 60% 85% 100%\n │ Bud │ Swelling │ Opening │ <- First bloom!\n 花芽〜つぼみ膨らみ始め開き始め開花\n\nFULL BLOOM RATE — progress toward mankai / 満開\n─────────────────────────────────────────────────\n 0% 20% 40% 70% 90% 100%\n │Open│ 30% │ 50% │ 70% │Full │ <- Mankai!\n 開花三分咲き五分咲き七分咲き満開\n```\n\nThe forecast model stays frozen at full-bloom=100% after peak and cannot detect petal fall or hazakura on its own. Spot observations (states 5–6) are the only way to confirm post-peak status for a specific park.\n\nPeak viewing is typically full bloom ± 3 days. Rain accelerates petal fall.\n\n---\n\n## Web app\n\n[seasons.kooexperience.com](https://seasons.kooexperience.com) is the interactive companion to this MCP server. It shows all the same data on a map — 1,012 sakura spots with lifecycle colours (orange bud, pink bloom, green ended), 687 koyo spots, 346 fruit farms grouped by location, and 90 flower spots. There are also focused SEO/citation pages for [cherry blossom forecasts](https://seasons.kooexperience.com/cherry-blossom-forecast), [autumn leaves forecasts](https://seasons.kooexperience.com/autumn-leaves-forecast), and the [MCP server](https://seasons.kooexperience.com/japan-seasonal-travel-mcp). The map includes a \"Plan My Trip\" mode where you pick cities and see every seasonal activity near each one ranked by distance, and a \"Near Me\" button that finds spots within 30km of your GPS location.\n\n---\n\n## Development\n\n```bash\ngit clone https://github.com/haomingkoo/japan-seasons-mcp.git\ncd japan-seasons-mcp\nnpm install\nnpm run build\nnpm start # stdio MCP mode\nnpm run start:http # HTTP mode, MCP at http://localhost:3000/mcp\n```\n\nTypeScript. No external database. No auth required.\n\n---\n\n## Data sources\n\n| Source | What it provides |\n|--------|-----------------|\n| [Japan Meteorological Corporation](https://n-kishou.com) | Sakura and koyo forecasts, bloom percentages, 1,700+ viewing spots |\n| [Japan Meteorological Agency](https://www.jma.go.jp) via [tsukumijima](https://weather.tsukumijima.net) | City weather forecasts |\n| [Jalan](https://www.jalan.net) / [Navitime](https://www.navitime.co.jp) | Fruit picking farm listings |\n| Hand-curated | 90 flower spots, 46 festival entries, each with an official URL and verified GPS |\n\n---\n\n## Contributing\n\nPRs welcome, especially for flower spots, festival entries, and farm corrections. See [CONTRIBUTING.md](https://github.com/haomingkoo/japan-seasons-mcp/blob/main/CONTRIBUTING.md).\n\n---\n\n## Formerly\n\nPreviously published as `japan-sakura-koyo-mcp` (deprecated). Use this package instead:\n\n```bash\nnpx -y japan-seasons-mcp\n```\n\n---\n\n## License\n\n[MIT](https://github.com/haomingkoo/japan-seasons-mcp/blob/main/LICENSE) · Built by [Haoming Koo](https://kooexperience.com)\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays","categoryDisplayName","Developer Tools","upstream",{"_94":95,"_96":97,"_98":99,"_100":101,"_102":-5},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_92":57,"_93":57},"ratingAvg","reviewCount","topics",[],"license","MIT","language","JavaScript","registryName","io.github.haomingkoo/japan-seasons","homepage","ENV",{"_105":106,"_107":108,"_109":110},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]