Log inSubmit server
Japan Seasons MCP logo

Japan Seasons MCP

by haomingkoo

Live Japan seasonal travel data covering sakura, autumn leaves, flowers, festivals, fruit picking, and weather.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Japan Seasons MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "haomingkoo-japan-seasons-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "japan-seasons-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

haomingkoo/japan-seasons-mcp connects MCP clients to live Japan seasonal travel data, including Japan Meteorological Corporation forecasts and observations. Its 17 tools cover broad seasonal questions, cherry blossoms, autumn leaves, spot retrieval, and citation-friendly search and fetch flows. Use it for date-specific trip planning when historical seasonal averages are not precise enough, or when you need named parks, temples, events, farms, and viewing areas. It runs through a hosted streamable HTTP endpoint or as a local stdio process with npx.

Use cases

  • Plan a Japan trip around current cherry blossom forecasts
  • Find autumn-leaf locations that match specific travel dates
  • Discover seasonal flowers, festivals, and fruit-picking farms
  • Compare bloom timing across Japanese cities
  • Retrieve canonical seasonal travel text for citations

Key features

  • Live JMC sakura and autumn-leaf data
  • 1,700+ GPS-tagged seasonal locations
  • Date-aware seasonal recommendations
  • 48-city cherry blossom forecasts
  • Search and fetch tools for retrieval workflows
  • Hosted HTTP and local stdio access

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

19/19 checks healthy over the last 80d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 12d ago via OSV.dev · japan-seasons-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads293Package downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Japan Seasons MCP works

What haomingkoo/japan-seasons-mcp does

haomingkoo/japan-seasons-mcp gives MCP-capable AI clients access to current and curated Japan travel-season information. Its coverage includes cherry blossoms, autumn leaves, Kawazu cherry, plum blossoms, wisteria, iris, hydrangea, lavender, sunflower and cosmos fields, fruit picking, fireworks and summer festivals, and winter events.

The dataset spans more than 1,700 GPS-tagged seasonal locations and includes 1,012 sakura parks and temples, 687 autumn-leaf viewing locations, and more than 2,100 fruit-picking farms across 14 fruits. Cherry blossom and autumn-leaf information comes from Japan Meteorological Corporation, while other categories use curated data or Jalan farm listings.

How it works

The server exposes 17 MCP tools. Broad questions can be sent to japan_seasonal_answer, which selects an appropriate live or curated dataset and produces a travel recommendation. sakura_now and koyo_now summarize current conditions, upcoming timing, and matches for a user's travel dates. sakura_forecast returns information for all 48 JMA observation cities, including forecast or observed dates and comparison with historical averages. sakura_spots provides specific viewing locations.

The search and fetch tools support retrieval-oriented workflows. Search returns result identifiers, while fetch returns full text and a canonical URL for citation-oriented use.

Sakura forecast information is updated daily at 9 AM Japan Standard Time, and individual spot observations change when JMC reporters submit updates. The service also provides a public map, text summary, and JSON forecast endpoints for web-retrieval workflows.

Setup and configuration

For a client that supports remote or streamable HTTP MCP, use:

https://seasons.kooexperience.com/mcp

For a local stdio setup, add a server entry that runs npx -y japan-seasons-mcp. The package can also be started locally in HTTP mode:

bash
PORT=3000 npx -y japan-seasons-mcp --http

The local MCP endpoint is then available at http://localhost:3000/mcp. Optional connection preferences include dateStyle (friendly or iso), temperatureUnit (celsius or fahrenheit), includeCoordinates (true or false), and mapLanguage (english or japanese).

For a persistent hosted-map cache, set JAPAN_SEASONS_CACHE_DIR to a durable directory. Without that setting, the application uses an in-memory cache and continues to work.

Tools and capabilities

  • Answer broad seasonal travel questions.
  • Summarize current sakura and koyo conditions.
  • Compare cherry blossom timing across 48 JMA cities.
  • Find named parks, temples, and other seasonal spots.
  • Search and fetch text suitable for retrieval and citation workflows.
  • Support date-based recommendations for travel planning.

Limitations and notes

MCP tool access requires the endpoint or local process to be configured in an MCP-capable client. Finding the project through web search does not grant permission to run its tools. Web-enabled assistants can instead use the public sakura text summary, forecast JSON endpoint, and interactive pages for retrieval and citations.

The service combines live JMC data with curated seasonal listings and Jalan fruit-farm data, so coverage and update behavior differ by category. Weather information can also affect recommendations, such as rain increasing petal fall during a blossom-viewing window.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Japan Seasons MCP

haomingkoo/japan-seasons-mcp is an MCP server that connects AI clients to live Japan seasonal travel data from Japan Meteorological Corporation and related curated sources. Its main tools answer broad seasonal questions, summarize sakura and autumn leaves, return cherry blossom forecasts and spots, and support search and fetch retrieval workflows.

Run it through npx with `npx -y japan-seasons-mcp` in an MCP client's stdio configuration. No package installation is needed for clients that support the hosted streamable HTTP endpoint; configure `https://seasons.kooexperience.com/mcp` instead.

Start it with `PORT=3000 npx -y japan-seasons-mcp --http`. The local MCP endpoint is `http://localhost:3000/mcp`; set `JAPAN_SEASONS_CACHE_DIR` to a persistent directory if you want the hosted web map cache to survive restarts.

Yes, Claude Desktop can run it as a local stdio server using an MCP configuration that invokes `npx` with the `-y japan-seasons-mcp` arguments. The hosted MCP endpoint is another option for clients that support remote or streamable HTTP MCP.

Related MCP servers

All in Travel & Transportation All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewJapan Seasons MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/haomingkoo-japan-seasons-mcp?style=directory)](https://allmcps.com/mcp/haomingkoo-japan-seasons-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/haomingkoo-japan-seasons-mcp"><img src="https://allmcps.com/api/badge/haomingkoo-japan-seasons-mcp?style=directory" alt="Japan Seasons MCP on AllMCPs" /></a>