SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI开发平台japan-seasons-mcp

japan-seasons-mcp

日本季节性旅行 MCP 服务器与互动地图，提供樱花、红叶、花卉、水果采摘和节庆等实时数据。收录 1,700+ 个 GPS 标记地点，数据来自日本气象协会（JMC），支持 Claude、ChatGPT、Gemini 等 MCP 客户端使用。提供 17 个工具，包括樱花当前状态（sakura_now）、红叶当前状态（koyo_now）、樱花预测（sakura_forecast）、樱花地点（sakura_spots）、红叶地点（koyo_spots）、最佳日期匹配（sakura_best_dates / koyo_best_dates）、花卉地点（flowers_spots）、节庆列表（festivals_list）、水果季节（fruit_seasons）、水果农场（fruit_farms）、天气预测（weather_forecast）等。内含 1,012 个樱花地点、687 个红叶地点、346 个水果农场、90 个花卉地点和 46 个节庆活动。支持远程 MCP 端点，也可配置本地 MCP 客户端。使用 TypeScript 开发，无需外部数据库和认证，MIT 许可。

访问官网

工具介绍

用途

japan-seasons-mcp 为 AI 助手提供日本季节性旅行的实时数据，解决 AI 基于陈旧训练数据回答樱花和红叶日期不准确的问题。通过连接日本气象协会（JMC）的实时预测数据，让 Claude、ChatGPT、Gemini 等 MCP 客户端能够给出准确的樱花开放、红叶变色、花卉观赏、水果采摘和节庆活动信息。

主要能力

  • 实时数据：接入日本气象协会（JMC）的预测和观测数据，数据每日更新。花期仪表每日 9:00 JST 更新，地点观测由 JMC 记者提交后更新。
  • 1,700+ 地点：覆盖 12 个季节性类别，包括 1,012 个樱花地点、687 个红叶地点、346 个水果农场、90 个花卉地点和 46 个主要节庆活动。所有地点均带 GPS 坐标。
  • 17 个工具：包括 japan_seasonal_answer（通用问答）、sakura_now（樱花当前状态）、koyo_now（红叶当前状态）、sakura_forecast（48 个城市樱花预测）、sakura_spots（樱花具体地点）、sakura_best_dates（旅行日期匹配）、kawazu_forecast（河津樱预测）、koyo_forecast（红叶预测）、koyo_best_dates（红叶日期匹配）、koyo_spots（红叶地点）、flowers_spots（花卉地点）、festivals_list（节庆列表）、fruit_seasons（水果季节）、fruit_farms（水果农场）、weather_forecast（3 天天气预报）等。
  • 多种数据源：同时提供可爬取的文本摘要、JSON API 和互动地图，方便 AI 搜索和引用。

使用方式

远程 MCP 端点（推荐）： 将以下 URL 添加为 MCP 服务器/应用/连接器： https://seasons.kooexperience.com/mcp

对于 ChatGPT Apps/Connectors：

  • Name: Japan in Seasons
  • 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.
  • Connector URL: https://seasons.kooexperience.com/mcp

本地 MCP 客户端（Claude Desktop / Claude Code / stdio MCP）： 将服务器添加到客户端的 MCP 配置中。

可爬取数据源（用于 AI 搜索）：

  • 樱花文本摘要：https://seasons.kooexperience.com/sakura-forecast.txt
  • 樱花预测 JSON：https://seasons.kooexperience.com/api/sakura/forecast
  • 互动地图和预测页面：https://seasons.kooexperience.com

可选连接偏好：

  • dateStyle — friendly 或 iso
  • temperatureUnit — celsius 或 fahrenheit
  • includeCoordinates — true 或 false
  • mapLanguage — english 或 japanese

可选持久缓存： 将 JAPAN_SEASONS_CACHE_DIR 指向持久卷（例如 Railway Volume 挂载到 /data），用于跨重启存储预热的国家级樱花/红叶全地点 JSON。无此设置则回退到内存缓存，仍可正常工作。

典型工作流：

  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。

适用场景

  • 用户询问“什么时候去京都看樱花最好？”
  • 用户询问“六月去日本有什么好玩的？”
  • 用户询问“十一月下旬去哪里看红叶？”
  • 用户询问“哪些季节性活动与我的旅行日期匹配？”
  • 用户想了解特定公园的樱花开放百分比和状态
  • 用户想查找水果采摘农场或节庆活动

限制

  • 花期预测存在自然波动，实际开花日期可能因温度变化而提前或推迟 2-3 周。
  • 观测数据仅在有 JMC 记者提交时更新，超过 48 小时的旧观测数据会作为上下文显示而非隐藏。
  • 预测模型在满开后冻结在 100%，无法自行检测花瓣掉落或叶樱状态，需依赖地点观测（状态 5-6）确认满开后的状态。
  • 优质观赏期通常为满开 ± 3 天，降雨会加速花瓣掉落。
  • MCP 工具仅在用户或工作区管理员在支持 MCP 的客户端中连接服务器后才可用；在网络搜索中发现此仓库并不会自动授予助手运行 MCP 工具的权限。
  • ChatGPT Search 可以发现此项目作为网页结果，但网页发现与连接 MCP 服务器不同。如果聊天仅启用了网络搜索，应引用可爬取的预测页面或 JSON API。要运行 sakura_now、sakura_forecast 或 sakura_spots 等工具，必须先将 MCP 端点添加为 ChatGPT 应用/连接器或在其他 MCP 客户端中配置。

技术细节

  • 使用 TypeScript 开发
  • 无需外部数据库
  • 无需认证
  • 静态数据集在启动时加载并从内存提供，每个请求无磁盘 I/O
  • 实时 JMC 数据在服务器端缓存（1-6 小时 TTL）
  • 全地点数据在启动时预压缩为 gzip，重复提供几乎无成本

其他信息

  • 互动地图 seasons.kooexperience.com 显示所有相同数据，包括 1,012 个樱花地点（带生命周期颜色：橙色花苞、粉色盛开、绿色结束）、687 个红叶地点、346 个水果农场（按位置分组）和 90 个花卉地点。
  • 地图包含“Plan My Trip”模式，可选择城市并查看附近所有季节性活动（按距离排序），以及“Near Me”按钮查找 GPS 位置 30 公里内的地点。
  • 欢迎 PR，尤其是花卉地点、节庆条目和农场更正。参见 CONTRIBUTING.md。
  • 此前以 japan-sakura-koyo-mcp 名称发布（已弃用），请使用当前包。
  • 许可：MIT
  • 作者：Haoming Koo

同类工具

查看分类