Japan Sakura & Koyo MCP

---

截图

樱花地图	地点详情与天气

水果采摘	日本活动一览

当季花卉	移动端

---

问题所在

你问 Claude、ChatGPT 或 Gemini：“我应该什么时候去京都看樱花？”

你得到的回答是“3 月下旬至 4 月上旬”——每年都一样，依据的是训练数据，根本不了解今年冬天的情况。

实际开花日期会因气温而前后浮动 2–3 周。东京的盛花期在 2024 年是 3 月 29 日，2023 年是 3 月 22 日，2022 年是 3 月 28 日——仅两年间就相差 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：

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
• 描述： 用于获取日本实时季节旅行数据：樱花和开花日期、红叶、鲜花、节庆、采摘水果和天气。最适合询问日本旅行的最新情况或特定日期信息。
• 连接器 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 月	樱花（sakura）	约 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 月	红叶（koyo）	约 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 — 全局概览

一次调用即可获取全部 48 个 JMA 观测城市的数据：今年的预报、已观测到的实际日期，以及各城市与历史平均值的比较。适合作为进一步查询具体地点前的起点。

"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 — 90 个精选地点，涵盖 8 种花卉，观赏期为 1 月至 10 月

类型	季节	知名地点
梅花	1 月至 3 月	热海、水户偕乐园
油菜花	2 月至 4 月	千叶海岸、昭和纪念公园
紫藤	4 月至 5 月	足利、河内、龟户天神
鸢尾花	5 月至 6 月	明治神宫、堀切菖蒲园
绣球花	6 月至 7 月	明月院、长谷寺、矢田寺
薰衣草	6 月至 7 月	富良野（北海道）
向日葵	7 月至 8 月	座间、北龙
波斯菊	9 月至 10 月	昭和纪念公园、常陆海滨公园

可按 type、prefecture 或 month 筛选。每个地点都附有官方网站 URL 和经过核实的 GPS 坐标。

---

节庆和活动

festivals_list — 46 个大型定期活动，附有官方网站 URL 和出席人数

"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 — 2,100 多个农场，附有 GPS 坐标和预约链接

传入 month=，即可自动筛选当季有水果可采摘的农场。添加 region= 可进一步缩小范围。

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

---

天气

weather_forecast — 为 51 个城市提供日本气象株式会社（JMA）的 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 小时）。所有景点的数据会在启动时预先进行 gzip 压缩，因此重复提供数据几乎没有开销。

---

花期等级参考

JMC 会为赏樱景点发布两种独立的数据产品，二者都会使用：

景点观测 — 由 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 天。降雨会加速花瓣飘落。

---

Web 应用

seasons.kooexperience.com 是此 MCP 服务的交互式配套应用。它会在地图上展示相同的所有数据 — 包括约 1,000 个带有花期颜色标示（橙色为花苞、粉色为开花、绿色为花期结束）的赏樱景点、687 个赏枫景点、按地点分组的 2,100 多个采摘农场，以及 90 个赏花景点。这里还有专门用于 SEO 和引用的页面：樱花预测、红叶预测和 MCP 服务。地图提供“Plan My Trip”模式，可供你选择城市并查看每座城市附近按距离排序的所有季节性活动；还有“Near Me”按钮，可查找 GPS 位置 30 km 范围内的景点。

---

开发

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 坐标

---

贡献

欢迎提交 PR，尤其欢迎补充赏花景点、节庆活动，以及修正农场信息。请参阅 CONTRIBUTING.md。

---

曾用名称

此项目此前以 japan-sakura-koyo-mcp（已弃用）发布。请改用此软件包：

npx -y japan-seasons-mcp

---

许可证

MIT · 由 Haoming Koo 开发