内容
<div align="center">
# 🌸 日本季节
**为您的 AI 助手提供实时的日本旅游数据 - 樱花预报、秋叶、摘果、鲜花、节日等。**
*1,700+ 个地点。17 个工具。来自日本气象厅的实时数据。*
[](https://www.npmjs.com/package/japan-seasons-mcp)
[](https://www.npmjs.com/package/japan-seasons-mcp)
[](./LICENSE)
[](#与AI助手结合使用)
[](https://seasons.kooexperience.com)
[](https://glama.ai/mcp/servers/haomingkoo/japan-seasons-mcp)
[](https://smithery.ai/server/haomingkoo/japan-seasons-mcp)
[**实时地图**](https://seasons.kooexperience.com) · [**托管 MCP 端点**](https://seasons.kooexperience.com/mcp) · [**npm**](https://www.npmjs.com/package/japan-seasons-mcp)
</div>
---
## 截图
| 樱花地图 | 地点详情和天气 |
|---|---|
| <img src="https://raw.githubusercontent.com/haomingkoo/japan-seasons-mcp/main/screenshots/08-sakura-zoomed.png" width="420"> | <img src="https://raw.githubusercontent.com/haomingkoo/japan-seasons-mcp/main/screenshots/02-sakura-popup.png" width="420"> |
| 摘果 | 日本活动 |
|---|---|
| <img src="https://raw.githubusercontent.com/haomingkoo/japan-seasons-mcp/main/screenshots/03-fruit-picking.png" width="420"> | <img src="https://raw.githubusercontent.com/haomingkoo/japan-seasons-mcp/main/screenshots/05-whatson.png" width="420"> |
| 季节鲜花 | 移动端 |
|---|---|
| <img src="https://raw.githubusercontent.com/haomingkoo/japan-seasons-mcp/main/screenshots/04-flowers.png" width="420"> | <img src="https://raw.githubusercontent.com/haomingkoo/japan-seasons-mcp/main/screenshots/07-mobile.png" width="420"> |
---
## 问题
你问克劳德、ChatGPT 或 Gemini： *"我什么时候去京都看樱花最好？"*
你得到的答案是“3 月下旬到 4 月初”——这是一个每年都一样的答案，基于的训练数据根本不知道这冬天是什么样的。
实际的开花日期因温度而异，2-3 周不等。东京在 2024 年达到峰值是在 3 月 29 日，在 2023 年是 3 月 22 日，在 2022 年是 3 月 28 日——仅仅两年就相差 7 天。你的 AI 在猜测。这个 MCP 服务器停止了猜测。
## 解决方案
它将克劳德（或任何 MCP 客户端）连接到日本气象厅的实时预报数据——与樱花导航和日本主要樱花预报网站相同的数据。盛开计量器每天 9 点更新；当 JMC 记者提交报告时，地点观察也会更新。
```
你： “我 4 月 8 日至 14 日在日本。哪里可以看樱花？”
克劳德：基于日本气象厅今天的预报数据：
城市开花期间你的访问：
• 仙台（宫城）- 预计 4 月 10 日开花（平均 4 月 12 日）
• 盛冈（岩手）- 预计 4 月 13 日开花（平均 4 月 16 日，提前）
• 秋田 - 预计 4 月 14 日开花
对于仙台，推荐的地点包括 Tsutsujigaoka 公园（92% 开花）和西公园。 Morioka 城堡遗址是一个经典景点。
有一件事要注意：4 月 10 日仙台有 40% 的降雨几率。降雨加速花瓣落，所以 4 月 11-12 日可能是一个更安全的窗口。
```
实时开花百分比。真实的公园名称。实时天气。
---
## 与 AI 助手结合使用
AI 助手可以通过两种方式使用日本季节：
1. **AI 搜索 / 网页浏览** 可以找到并引用公共页面、文本摘要和 JSON API。这是人们在 ChatGPT、Perplexity、Google AI 模式等中询问“最新的樱花日期”时摩擦最小的路径。
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：
```text
https://seasons.kooexperience.com/mcp
```
对于 ChatGPT 应用程序/连接器，请使用：
- **名称：** `日本季节`
- **描述：** `用于实时日本季节旅行数据：樱花和樱花日期、秋叶、鲜花、节日、摘果和天气。适用于当前或特定日期的日本旅行问题。`
- **连接器 URL：** `https://seasons.kooexperience.com/mcp`
### 克劳德桌面 / 克劳德代码 / stdio MCP 客户端
将以下内容添加到客户端的 MCP 配置中：
```json
{
"mcpServers": {
"japan-seasons": {
"command": "npx",
"args": ["-y", "japan-seasons-mcp"]
}
}
}
```
### 自托管
```bash
PORT=3000 npx -y japan-seasons-mcp --http
# MCP 端点：http://localhost:3000/mcp
```
托管网页地图的持久缓存：
```bash
JAPAN_SEASONS_CACHE_DIR=/data PORT=3000 npx -y japan-seasons-mcp --http
```
将 `JAPAN_SEASONS_CACHE_DIR` 指向持久卷，例如 Railway Volume 挂载到 `/data`。这存储了预热的国家樱花/秋叶所有地点 JSON，重启时仍可用；如果没有，则应用程序恢复到内存缓存，仍然有效。
### 为什么 ChatGPT 可能找到它但拒绝使用它
ChatGPT 搜索可以发现 `japan-seasons-mcp` 作为网页结果，但网页发现与连接 MCP 服务器不同。如果聊天仅启用了网页搜索，它应该引用可爬取的预报页面或 JSON API。要运行诸如 `sakura_now`、`sakura_forecast` 或 `sakura_spots` 之类的工具，必须先将 MCP 端点添加为 ChatGPT 应用程序/连接器或在另一个 MCP 客户端中配置。
---
## 涵盖内容
| 季节 | 数据 | 地点 | 来源 |
|--------|------|-------|--------|
| 1 月 - 2 月 | 河津樱（早期深粉色品种，伊豆半岛） | 9 个地点 | 日本气象厅 实时 |
| 1 月 - 3 月 | 梅花 | 8 个地点 | 精选 |
| 3 月 - 5 月 | 樱花（sakura） | **1,012 个公园和寺庙** | 日本气象厅 实时，每天 |
| 4 月 - 5 月 | 紫藤 | 13 个地点 | 精选 |
| 5 月 - 6 月 | 鸢尾花园 | 9 个地点 | 精选 |
| 6 月 - 7 月 | 紫色绣球花 | 15 个地点 | 精选 |
| 6 月 - 7 月 | 薰衣草田 | 6 个地点 | 精选 |
| 7 月 - 8 月 | 烟花节和夏季 Matsuri | 46 个活动 | 精选 |
| 7 月 - 8 月 | 向日葵田 | 7 个地点 | 精选 |
| 5 月 - 11 月 | 摘果 | **346 个农场**，14 种水果 | Jalan + Navitime |
| 9 月 - 10 月 | 宇宙花田 | 8 个地点 | 精选 |
| 10 月 - 12 月 | 秋叶（koyo） | **687 个观赏地点** | 日本气象厅 实时 |
| 1 月 - 2 月 | 冬季活动（札幌雪节等） | 8 个活动 | 精选 |
1,700+ 个 GPS 标记的地点，涵盖 12 个季节类别。
---
## 工具
### 最佳首选工具
**`japan_seasonal_answer`** - 回答广泛的旅行者问题
在有人提出通常的问题而不是命名数据集时使用此工具：“樱花预报怎么样？”，“日本 6 月份有什么好玩的？”，“11 月下旬去哪里看秋叶比较好？”，或“我的日期有哪些季节活动相符？” 它会路由到正确的实时或精选数据集，并返回一个可以直接使用的建议。
**`sakura_now`** - 当前樱花答案
针对广泛的樱花提示的最佳首选调用。它总结了当前的情况、下一步的最佳时机或与用户旅行日期的匹配，使用实时 JMC 预报/观察数据，并包括一个特定的观赏地点列表，当有可用数据时。
**`koyo_now`** - 当前的秋叶答案
秋叶的等价于 `sakura_now`：当前的时机、枫树/银杏峰值、旅行日期匹配和下一步指导，用于确切的地点。
**`search` / `fetch`** - 检索友好访问
提供商友好的搜索/检索工具，用于 ChatGPT 风格的检索和深入研究引用流程。`search` 返回结果 ID；`fetch` 返回带有规范 URL 的完整文本。
### 樱花
**`sakura_forecast`** - 大局
所有 48 个 JMA 观测城市一次性调用：今年的预报、观测到的实际日期以及每个城市与历史平均值的比较。 在深入研究特定地点之前，这是一个很好的起点。
```
"日本现在的樱花情况怎么样？”
→ 按地区划分 48 个城市，盛开状态，预报日期，日期 vs 平均值
```
**`sakura_spots`** - 特定公园和寺庙
日本全国 1,012 个地点，当前状态，盛开百分比和 GPS 坐标。当 JMC 地点记者在 48 小时内提交了最近的更新时，该工具使用该观测状态作为主要读取内容。否则，它会回落到 JMC 盛开计量器预报。过时的观察结果作为上下文显示，不会隐藏。
```
"京都的樱花景点"
→ 51 个地点： 清水寺（4 月 9 日全开，4 月 9 日观测）、 丸山公园（91% 盛开...）
```
**`sakura_best_dates`** - 匹配旅行日期到盛开
提供开始和结束日期，返回城市，其中包括盛开窗口与您的窗口重叠，以及当有可用数据时特定观赏地点的建议列表。
```
"我 4 月 8 日至 14 日在日本，应该去哪里？”
→ 城市在该窗口内盛开，按时间排名，以及地点建议和地图链接
```
**`kawazu_forecast`** - 早期深粉色品种
河津樱花 1 月 - 2 月在伊豆半岛开花，比标准樱花开花早几个月。
```
"2 月份可以看樱花吗？”
→ 9 个 Kawazu 地点，盛开 %，GPS，预报日期
```
---
### 秋叶
**`koyo_forecast`** - 城市的枫树和银杏时间
50+ 个城市提供今年的变色日期以及与历史正常值的比较。 枫树和银杏在不同时间达到峰值；两者都包含在内。
```
"京都和北海道的秋叶什么时候达到峰值？”
→ 城市的枫树/银杏日期，早晚 vs 平均值
```
**`koyo_best_dates`** - 与 sakura_best_dates 类似，用于秋叶
将您的旅行窗口与城市的峰色匹配。
```
"10 月下旬去日本哪里看秋叶？”
→ 城市在您的日期达到峰值，枫树和银杏时间
```
**`koyo_spots`** - 687 个观赏地点按 prefecture
每个地点都有一个盛开窗口（开始，峰值，结束），叶类型，流行度评分和 GPS。
```
"京都最佳的秋叶景点"
→ 嵯峨山、永定寺、东福寺、琉璃院... 带有星级评分和确切的峰值日期
```
---
### 鲜花
**`flowers_spots`** - 90 个精选地点，8 种花卉类型，1 月至 10 月
| 类型 | 季节 | 值得注意的地点 |
|------|---------|--------------|
| 梅花 | 1 月 - 3 月 | 热海、 Mito Kairakuen |
| 樱花 | 4 月 - 5 月 | |
| 紫藤 | 4 月 - 5 月 | |
| 鸢尾花 | 5 月 - 6 月 | |
| 紫色绣球花 | 6 月 - 7 月 | |
| 薰衣草 | 6 月 - 7 月 | |
| 向日葵 | 7 月 - 8 月 | |
| 宇宙花田 | 9 月 - 10 月 | |
按 `类型`、`省` 或 `月` 过滤。每个地点都有官方网址和验证的 GPS。
---
### 节日和活动
**`festivals_list`** - 46 个主要循环活动，官方网址和出席人数
```
"日本最好的烟花节？”
→ 隅田川（90 万），长崎（110 万），大魔王 PL 大阪，PL 大阪，...`
按 `类型`（烟花 / matsuri / 冬季）、`月` 和 `省` 过滤。
---
### 摘果
**`fruit_seasons`** - 全年 14 种水果的完整日历
`What fruits are in season and at peak for any given month？”
→ Grape at peak (Yamanashi, Nagano), Pear at peak, Peach ending, Apple starting
```
**`fruit_farms`** - 346 个农场，附带 GPS 和预订链接
传 `month=` 它会自动筛选到有季节水果的农场。添加 `region=` 以进一步缩小范围。
```
"4 月份东京附近的草莓农场”
→ 东京/关东地区的草莓季节农场，GPS + Jalan 链接
```
---
### 天气
**`weather_forecast`** - 51 个城市的 3 天 JMC 预报
温度，6 小时窗口内的降雨概率和状况。值得检查，因为降雨会加速花瓣落。
```
"大阪这个周末的天气怎么样？”
→ 最高/最低温度，6 小时窗口降雨百分比，状况
```
---
## 用法
向您的 MCP 客户端询问目标，而不是工具名称。以下是几个好的例子：
```text
"我 4 月 8 日至 14 日在日本。哪里可以看樱花？”
"京都 11 月下旬的秋叶最佳景点”
"日本 6 月份有哪些季节性花卉？”
"日本 8 月份最好的烟花节在哪里？”
"东京 5 月份附近有哪些摘果景点？”
“大阪这个周末的降雨会使樱花变差吗？”
```
典型工作流程：
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 坐标的输出，请设置可选的连接首选项。
---
## 它是如何工作的
```mermaid
flowchart LR
subgraph live["实时 API（缓存 1-6 小时）"]
JMC["日本气象厅\n樱花 · 秋叶 · 河津樱\n1,700+ 地点 · 每天 9 点 JST"]
JMA["日本气象厅\n天气 · 51 个城市\n每小时"]
end
subgraph static["静态数据集（启动时加载）"]
DATA["flowers.json — 90 个地点\nfestivals.json — 46 个活动\nfruit-farms.json — 346 个农场"]
end
subgraph server["japan-seasons-mcp"]
MCP["17 个工具\n2 个提示\nstdio + HTTP 传输"]
end
subgraph clients["MCP 客户端"]
C1["克劳德桌面\n/ 克劳德代码"]
C2["光标\n/ 风浪]
C3["任意 MCP\n客户端"]
end
JMC -->|实时获取| MCP
JMA -->|实时获取| MCP
DATA -->|内存中| MCP
MCP -->|MCP 协议| C1
MCP -->|MCP 协议| C2
MCP -->|MCP 协议| C3
```
### 樱花开花程度参考
JMC 为樱花景点发布了两种独立的数据产品。两者都使用：
**地点观察** - 由 JMC 合作伙伴和地点管理员报告，用于在 48 小时内更新时作为主要状态：
```
状态 0 萌芽（可见芽）
状态 1 初开 — 開花（少量花开）
状态 2 30% 开花 — 三分咲き（三分开）
状态 3 70% 开花 — 七分咲き（七分开）
状态 4 全开 — 満開（满开）
状态 5 花瓣开始脱落 — 散り始め
状态 6 绿叶 — 葉桜（开花季节结束）
```
**开花预测**（jr_data）- 数学模型用作无新鲜观测时的备用：
```
开花率 - 向初开（開花）推进的进度
─────────────────────────────────────────────────
0% 60% 85% 100%
│ 芽 │ 增厚 │ 开放 │ <- 初开！
花芽〜つぼみ 膨らみ始め 開き始め 開花
满开率 - 向满开 / 満開推进的进度
─────────────────────────────────────────────────
0% 20% 40% 70% 90% 100%
│开放│ 30% │ 50% │ 70% │满开│ <- 满开！
开花 三分咲き 五分咲き 七分咲き 满开
```
通常，峰值观赏期在满开 ± 3 天内。降雨加速花瓣脱落。
---
## 网络应用
[seasons.kooexperience.com](https://seasons.kooexperience.com) 是本 MCP 服务器的交互式配套工具。它在地图上显示所有相同的数据 - 1,012 个樱花景点，具有生命周期颜色（橙色芽，粉色开花，绿色结束），687 个秋叶景点，346 个摘果农场按位置分组，以及 90 个鲜花景点。还有一个“计划我的行程”模式，您可以选择城市，查看每个城市附近的季节活动，并按距离排名，以及一个“附近”按钮，查找您所在位置 30 公里范围内的景点。
---
## 开发
```bash
git clone https://github.com/haomingkoo/japan-seasons-mcp.git
cd japan-seasons-mcp
npm install
npm run build
npm start # stdio MCP 模式
npm run start:http # HTTP 模式，MCP 在 http://localhost:3000/mcp
```
TypeScript。无外部数据库。无需身份验证。
---
## 数据来源
| 来源 | 提供内容 |
|--------|-----------------|
| [日本气象厅](https://n-kishou.com) | 樱花和秋叶预报，盛开百分比，1,700+ 个观赏地点 |
| [日本气象厅](https://www.jma.go.jp) 通过 [tsukumijima](https://weather.tsukumijima.net) | 城市天气预报 |
| [jalan](https://www.jalan.net) / [Navitime](https://www.navitime.co.jp) | 摘果农场列表 |
| 精选 | 90 个花卉景点，46 个节日，每个都有官方网址和验证的 GPS |
---
## 贡献
欢迎提交 PR，尤其是鲜花景点、节日条目和农场更正。请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。
---
## 前身
以前发布为 `japan-sakura-koyo-mcp`（已弃用）。使用此软件包代替：
```bash
npx -y japan-seasons-mcp
```
---
## 许可证
[MIT](LICENSE) · 由 [Haoming Koo](https://kooexperience.com) 构建
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器