Japan Sakura & Koyo MCP

---

スクリーンショット

桜マップ	スポットの詳細と天気

フルーツ狩り	日本のイベント情報

季節の花	モバイル

---

問題点

Claude、ChatGPT、Geminiにこう尋ねます。「京都で桜を見るには、いつ行くのがいいですか？」

返ってくるのは「3月下旬から4月上旬」です。毎年同じ回答で、その冬の気候をまったく知らない学習データに基づいています。

気温によって、実際の開花日は2〜3週間ずれます。東京の満開日は2024年が3月29日、2023年が3月22日、2022年が3月28日でした。わずか2年間で7日も差があります。AIは推測しているのです。このMCP サーバーが、その推測をなくします。

解決策

Claude（または任意のMCP クライアント）を、Japan Meteorological Corporationのライブ予想データに接続します。このデータは、SAKURA NAVIや日本の主要な桜予想サイトでも使われています。開花メーターは日本時間の午前9時に毎日更新され、スポットの観測情報はJMCの担当者から報告が届くたびに更新されます。

You:    "I'm in Japan April 8–14. Where should I see cherry blossoms?"

Claude: Based on today's JMC forecast data:

        Cities in full bloom during your visit:
        • Sendai (Miyagi) — full bloom forecast Apr 10 (avg Apr 12)
        • Morioka (Iwate) — full bloom forecast Apr 13 (avg Apr 16, running early)
        • Akita — full bloom forecast Apr 14

        For Sendai, top spots include Tsutsujigaoka Park (92% full bloom today)
        and Nishi Park. Morioka Castle ruins are a classic.

        One thing to watch: 40% rain chance Apr 10 in Sendai. Rain speeds up
        petal fall, so Apr 11–12 is probably the safer window.

実際の開花率。実在する公園名。実際の天気。

---

AI アシスタントでの使い方

AI アシスタントが Japan in Seasons を利用する方法は、次の 2 通りです。

1. AI 検索／ウェブ閲覧では、公開ページ、テキストの概要、JSON API を検索して引用できます。ChatGPT、Perplexity、Google AI Mode などで「最新の桜の開花日」を尋ねるユーザーにとって、最も手軽な方法です。
2. MCP ツールの利用は、ユーザーまたはワークスペース管理者が、MCP に対応したクライアント内で MCP サーバーに接続した後にのみ可能です。検索でこのリポジトリが見つかっても、アシスタントに MCP ツールを実行する権限が付与されるわけではありません。

AI 検索では、次のクロール可能な情報源を利用してください。

• 最新の桜のテキスト概要：https://seasons.kooexperience.com/sakura-forecast.txt
• 桜の開花予想 JSON：https://seasons.kooexperience.com/api/sakura/forecast
• インタラクティブマップと開花予想ページ：https://seasons.kooexperience.com

リモート MCP エンドポイント

クライアントがリモート／ストリーミング可能な HTTP MCP に対応している場合、パッケージのインストールは不要です。これを MCP サーバー／アプリ／コネクターの URL として追加してください。

https://seasons.kooexperience.com/mcp

ChatGPT Apps/Connectors では、次を使用してください。

• 名前： Japan in Seasons
• 説明： 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.
• コネクター URL： https://seasons.kooexperience.com/mcp

Claude Desktop / Claude Code / stdio MCP クライアント

クライアントの MCP 設定に次を追加してください。

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

ホスト型エンドポイントでは、次の接続設定も利用できます。

• dateStyle — friendly または iso
• temperatureUnit — celsius または fahrenheit
• includeCoordinates — true または false
• mapLanguage — english または japanese

セルフホスト

PORT=3000 npx -y japan-seasons-mcp --http
# MCP endpoint: http://localhost:3000/mcp

ホスト型ウェブマップで利用できる、任意の永続キャッシュ：

JAPAN_SEASONS_CACHE_DIR=/data PORT=3000 npx -y japan-seasons-mcp --http

JAPAN_SEASONS_CACHE_DIR を永続ボリュームに設定してください。たとえば、/data にマウントした Railway Volume を指定できます。これにより、キャッシュ済みの全国の桜／紅葉の全スポット JSON が再起動後も保持されます。指定しない場合、アプリはメモリ内キャッシュに切り替わりますが、引き続き動作します。

ChatGPT が情報を見つけても利用を拒否することがある理由

ChatGPT Search はウェブ検索結果として japan-seasons-mcp を見つけることがありますが、ウェブ上で見つけることと MCP サーバーに接続することは別です。チャットでウェブ検索のみが有効になっている場合は、クロール可能な開花予想ページまたは JSON API を引用する必要があります。sakura_now、sakura_forecast、sakura_spots などのツールを実行するには、まず MCP エンドポイントを ChatGPT アプリ／コネクターとして追加するか、別の MCP クライアントで設定する必要があります。

---

対応する季節情報

季節	データ	スポット	情報源
1～2 月	河津桜（伊豆半島で見られる、早咲きの濃いピンク色の品種）	9 か所	JMC のライブデータ
1～3 月	梅	8 か所	厳選
3～5 月	桜	約 1,000 か所の公園・寺院	JMC のライブデータ、毎日更新
4～5 月	藤	13 か所	厳選
5～6 月	菖蒲園	9 か所	厳選
6～7 月	あじさい	15 か所	厳選
6～7 月	ラベンダー畑	6 か所	厳選
7～8 月	花火大会・夏祭り	46 件	厳選
7～8 月	ひまわり畑	7 か所	厳選
5～11 月	フルーツ狩り	2,100 か所以上の農園、14 種類の果物	Jalan
9～10 月	コスモス畑	8 か所	厳選
10～12 月	紅葉	約 700 か所の観賞スポット	JMC のライブデータ
1～2 月	冬のイベント（さっぽろ雪まつりなど）	8 件	厳選

JMC によるスポットの追加・終了に伴い、スポット数は変動します。ライブ API では現在の合計数（totalSpots）を確認できます。

---

ツール

最初の呼び出しにおすすめのツール

japan_seasonal_answer — 旅行者からの幅広い質問に回答

データセット名ではなく、一般的な質問をされた場合に使います。「桜の開花予想はどうですか？」「6月の日本でおすすめのものは何ですか？」「11月下旬に紅葉を見るならどこがいいですか？」「旅行日程に合う季節のアクティビティは何ですか？」などの質問に対応します。適切な最新または厳選データセットを参照し、そのまま使えるおすすめ情報を返します。

sakura_now — 現在の桜情報に回答

幅広い桜関連の質問に最初に呼び出すのに最適なツールです。JMC の最新の予想・観測データを使って、今見頃の場所、次に見頃を迎える場所、または旅行日程に合う場所を要約します。スポットデータがある場合は、具体的な観賞スポットの短いリストも含まれます。

koyo_now — 現在の紅葉情報に回答

sakura_now の紅葉版です。現在の紅葉時期、モミジやイチョウの見頃、旅行日程に合う場所、具体的なスポットを探すための次の手順を案内します。

search / fetch — 検索・取得に適したアクセス方法

ChatGPT のような検索や、ディープリサーチの引用フローに適したプロバイダー向けの検索・取得ツールです。search は結果 ID を返し、fetch は正規 URL を含む全文を返します。

桜

sakura_forecast — 全体像を把握

JMA の観測都市全48か所を1回の呼び出しで確認できます。今年の予想、観測済みの場合は実際の日付、各都市と過去の平均との比較を取得できます。具体的なスポットを調べる前の出発点として最適です。

"What's the cherry blossom situation in Japan right now?"
→ 48 cities by region, bloom status, forecast dates, days vs average

sakura_spots — 公園や寺院などの具体的なスポット

日本全国の約1,000か所のスポットについて、現在の状況、開花率、GPS 座標を確認できます。JMC のスポット報告者が最近（過去48時間以内）に更新を報告している場合、その観測状況を優先して表示します。それ以外の場合は、JMC の開花メーター予想を表示します。古い観測情報も隠さず、参考情報として表示します。

"Cherry blossom spots in Kyoto"
→ 51 spots: Kiyomizu-dera (Full bloom, observed Apr 9), Maruyama Park (91% full-bloom)...

sakura_best_dates — 旅行日程に合う開花時期を検索

開始日と終了日を指定すると、旅行期間と満開時期が重なる都市に加え、スポットデータがある場合は具体的な観賞スポットの短いリストが返されます。

"I'm in Japan April 8–14, where should I go?"
→ Cities with bloom in that window, ranked by timing, plus spot suggestions and map links

kawazu_forecast — 早咲きの濃いピンク色の品種

河津桜は、通常の桜が各地で咲き始める数か月前の1月〜2月に、伊豆半島で開花します。

"Can I see cherry blossoms in February?"
→ 9 Kawazu spots with bloom %, GPS, forecast dates

---

紅葉

koyo_forecast — 都市ごとのモミジ・イチョウの見頃

50以上の都市について、今年の色づき日と過去の平年値との比較を確認できます。モミジとイチョウは見頃の時期が異なるため、両方の情報を掲載しています。

"When do autumn leaves peak in Kyoto vs Hokkaido?"
→ City-by-city maple/ginkgo dates, days early or late vs average

koyo_best_dates — 紅葉向けの、桜の見頃日検索と同様の機能

旅行期間に合わせて、紅葉が見頃を迎える都市を検索します。

"I'm in Japan late October, where for autumn leaves?"
→ Cities in peak colour during your dates, maple vs ginkgo timing

koyo_spots — 都道府県別の観賞スポット687か所

各スポットには見頃の期間（開始・ピーク・終了）、葉の種類、人気度、GPS 情報が含まれます。

"Top autumn leaves spots in Kyoto"
→ Arashiyama, Eikando, Tofukuji, Rurikoin... with star rating and exact peak dates

---

花

flowers_spots — 8種類の花、1月から10月までの厳選スポット90か所

種類	季節	主なスポット
梅	1月〜3月	熱海、水戸偕楽園
菜の花	2月〜4月	千葉の海岸、昭和記念公園
藤	4月〜5月	あしかが、河内、亀戸天神
花菖蒲	5月〜6月	明治神宮、堀切菖蒲園
アジサイ	6月〜7月	明月院、長谷寺、矢田寺
ラベンダー	6月〜7月	富良野（北海道）
ヒマワリ	7月〜8月	座間、北竜
コスモス	9月〜10月	昭和記念公園、ひたち海浜公園

type、prefecture、month で絞り込めます。各スポットには公式 URL と確認済みの GPS 情報があります。

---

祭りとイベント

festivals_list — 公式 URL と来場者数を含む、定期開催の主要イベント46件

"Best fireworks festivals in Japan?"
→ Sumida River (900k), Nagaoka (1.1M), Omagari, PL Osaka, Miyajima...

"Festivals in Kyoto in October?"
→ Jidai Matsuri (Oct 22), Kurama Fire Festival, with booking tips

type（花火／祭り／冬）、month、prefecture で絞り込めます。

---

果物狩り

fruit_seasons — 14種類の果物を網羅した年間カレンダー

任意の月について、旬や最盛期を迎える果物、適した地域、補足情報を確認できます。

"What fruit can I pick in September in Japan?"
→ Grape at peak (Yamanashi, Nagano), Pear at peak, Peach ending, Apple starting

fruit_farms — GPS 情報と予約リンク付きの農園2,100か所以上

month= を渡すと、その時期に旬の果物がある農園に自動で絞り込みます。region= を追加すると、さらに地域を絞り込めます。

"Strawberry farms near Tokyo in April"
→ Farms in the Tokyo/Kanto area with strawberry in season, GPS + Jalan links

---

天気

weather_forecast — 51 都市の気象庁による 3 日間の予報

気温、6 時間ごとの降水確率、天候を確認できます。雨が花びらの落下を早めるため、確認する価値があります。

"Weather in Osaka this weekend?"
→ Min/max temp, rain % per 6-hour window, conditions

---

使い方

ツール名ではなく、目的を MCP クライアントに伝えてください。たとえば、次のように尋ねられます。

"I'm in Japan April 8-14. Where should I go for cherry blossoms?"
"Top autumn leaves spots in Kyoto in late November"
"What flowers are in season in Japan in June?"
"Best fireworks festivals in Japan in August"
"Fruit picking near Tokyo in May"
"Will rain in Osaka this weekend make sakura worse?"

一般的なワークフロー：

1. まず sakura_best_dates、koyo_best_dates、sakura_forecast、または koyo_forecast で見頃を尋ねます。
2. sakura_spots、koyo_spots、fruit_farms、flowers_spots、または festivals_list で、公園、寺院、農園、イベントの詳細を確認します。
3. 雨や気温によっておすすめが変わる可能性がある場合は、weather_forecast を確認します。
4. ISO 日付、華氏の天気、日本語の地図リンク、または GPS 座標なしの出力を希望する場合は、任意の接続設定を行います。

---

仕組み

flowchart LR
    subgraph live["Live APIs (cached 1–6h)"]
        JMC["Japan Meteorological Corp\nsakura · koyo · kawazu\nabout 1,700 spots · daily 9AM JST"]
        JMA["Japan Met Agency\nweather · 51 cities\nhourly"]
    end

    subgraph static["Static datasets (loaded at startup)"]
        DATA["flowers.json — 90 spots\nfestivals.json — 46 events\nfruit-farms.json — 2,100+ farms"]
    end

    subgraph server["japan-seasons-mcp"]
        MCP["17 tools\n2 prompts\nstdio + HTTP transport"]
    end

    subgraph clients["MCP clients"]
        C1["Claude Desktop\n/ Claude Code"]
        C2["Cursor\n/ Windsurf"]
        C3["Any MCP\nclient"]
    end

    JMC -->|live fetch| MCP
    JMA -->|live fetch| MCP
    DATA -->|in-memory| MCP
    MCP -->|MCP protocol| C1
    MCP -->|MCP protocol| C2
    MCP -->|MCP protocol| C3

静的データセットは起動時に読み込まれ、リクエストごとのディスク I/O なしでメモリから提供されます。JMC のライブデータはサーバー側でキャッシュされます（TTL は 1～6 時間）。すべてのスポット情報は起動時に事前圧縮されるため、繰り返しの提供にかかるコストは実質的にありません。

---

開花状況の基準

JMC は桜スポットについて、別々のデータを 2 種類公開しています。どちらも使用します。

スポット観測情報 — JMC のパートナーおよびスポット管理者から報告され、48 時間以内に更新されている場合は、主要な状況データとして使用します。

State 0  Pre-bloom (buds visible)
State 1  First bloom — 開花 (a few flowers open)
State 2  30% bloom — 三分咲き (sanbu-zaki)
State 3  70% bloom — 七分咲き (nanabu-zaki)
State 4  Full bloom — 満開 (mankai)
State 5  Petals starting to fall — 散り始め
State 6  Green leaves — 葉桜 (hazakura, bloom season over)

開花メーター予測（jr_data）— 新しい観測情報がない場合のフォールバックとして使われる数学モデルです。

BLOOM RATE — progress toward first bloom (開花)
─────────────────────────────────────────────────
 0%      60%       85%      100%
 │  Bud   │ Swelling │ Opening │ <- First bloom!
 花芽〜つぼみ  膨らみ始め   開き始め    開花

FULL BLOOM RATE — progress toward mankai / 満開
─────────────────────────────────────────────────
 0%   20%   40%   70%   90%  100%
 │Open│ 30% │ 50% │ 70% │Full │ <- Mankai!
 開花  三分咲き 五分咲き 七分咲き 満開

予測モデルは満開のピーク後も 100％のまま変化せず、花びらの落下や葉桜を単独では検知できません。特定の公園でピーク後の状況を確認できるのは、スポット観測情報（状態 5～6）のみです。

見頃のピークは通常、満開日の前後 3 日間です。雨は花びらの落下を早めます。

---

ウェブアプリ

seasons.kooexperience.com は、この MCP サーバーと連携するインタラクティブなアプリです。地図上で同じデータを確認できます。約 1,000 か所の桜スポット（オレンジはつぼみ、ピンクは開花、緑は終了を示すライフサイクル別の色分け）、687 か所の紅葉スポット、場所ごとにまとめた 2,100 か所以上の果物狩り農園、90 か所の花スポットを掲載しています。また、桜の開花予報、紅葉の予報、MCP サーバーに関する、SEO と引用に特化したページもあります。地図には、都市を選ぶと各都市の周辺にあるすべての季節のアクティビティを距離順に表示する「旅行を計画」モードと、GPS の現在地から 30km 以内のスポットを検索する「近くを検索」ボタンがあります。

---

開発

git clone https://github.com/haomingkoo/japan-seasons-mcp.git
cd japan-seasons-mcp
npm install
npm run build
npm start            # stdio MCP mode
npm run start:http   # HTTP mode, MCP at http://localhost:3000/mcp

TypeScript を使用しています。外部データベースはありません。認証は不要です。

---

データソース

ソース	提供データ
Japan Meteorological Corporation	桜と紅葉の予報、開花率、約 1,700 か所の観賞スポット
Japan Meteorological Agency（tsukumijima 経由）	都市の天気予報
Jalan	果物狩り農園の掲載情報
手作業で編集	90 か所の花スポット、46 件の祭り情報。それぞれに公式 URL と確認済み GPS 座標があります

---

貢献

プルリクエストを歓迎します。特に、花スポット、祭り情報、農園情報の修正をお待ちしています。CONTRIBUTING.md をご覧ください。

---

以前の名称

以前は japan-sakura-koyo-mcp として公開されていました（非推奨）。代わりに、次のパッケージを使用してください。

npx -y japan-seasons-mcp

---

ライセンス

MIT · Haoming Koo が作成