看雪山 Kanxueshan

io.github.geoxingPublished by GitHub account geoxingv1.0.0Updated Oct 24, 2026

日照金山预报:中国雪山 7 天内的日出/日落金光时段与可见度评分。Golden-hour forecasts for snow mountains in China.

VerifiedStreamable HTTPWeb executableLocation & LifestyleData & Analytics

Overview

AI-generated overview

Remote MCP server that forecasts golden-hour sunrise and sunset light on snow mountains in China, with visibility scores and viewpoint suggestions.

What you can do
  • Search Chinese snow mountains and their viewpoints by name keyword
  • Find visible peaks near a latitude/longitude and get today's golden-light forecast
  • Get a 1-7 day golden-hour forecast for a named peak, optionally for a specific viewpoint
  • Returns golden-hour windows, a 0-100 visibility score, and weather factors such as cloud cover, humidity and wind
When to use it
Useful when planning a trip or photo shoot around Chinese snow mountains and you want to know whether sunrise or sunset light on the peak is likely to be visible from a given pass or viewpoint.
Requirements
A remote streamable HTTP endpoint; the hosted endpoint is free and needs no API key or account. Self-hosting requires Python, the listed dependencies, and your own backend API address supplied via the KXS_API environment variable.
Before you install
Forecasts are estimates based on weather and terrain models, not guarantees. Self-hosting can optionally log every tool call (name, parameters, source IP, duration, outcome) to a file or SQLite database via KXS_TOOL_LOG or KXS_STATS_DB; leaving both unset writes nothing to disk. Forecast responses are in Chinese.

Installation

In SourceWeft

  1. Open 看雪山 Kanxueshan in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.geoxing%2Fkanxueshan/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "kanxueshan": {
      "type": "http",
      "url": "https://www.yilong.art/mcp"
    }
  }
}

README

看雪山 MCP · Kanxueshan MCP

🏔️ 日照金山(雪山金光)预报的 MCP 服务器 —— 在 Claude、Cursor、Cherry Studio、Claude Desktop 等任何 MCP 客户端里,直接问:

「这个周末去子梅垭口,能看到贡嘎山日照金山吗?」 「明天在飞来寺,能看到卡瓦格博吗?」 「30.9, 102.8 附近有哪些雪山可以看?」

返回:日出/日落金光时段、0-100 可见度评分、云量/湿度/风速因子,以及观景点建议。

[看雪山]

直接用(推荐,无需安装)

托管端点(streamable HTTP,免费、无需 API Key):

https://www.yilong.art/mcp

Claude Code / 命令行

bash
claude mcp add --transport http kanxueshan https://www.yilong.art/mcp

Cursor(~/.cursor/mcp.json)

json
{  "mcpServers": {    "kanxueshan": { "url": "https://www.yilong.art/mcp" }  }}

其他客户端:在「MCP / 连接器」设置里添加远程 HTTP 服务器,地址填 https://www.yilong.art/mcp。 图文接入指引:https://www.yilong.art/ai.html ・ 网页版:https://www.yilong.art

工具(Tools)

工具说明参数
search_peak搜索中国雪山及观景点(子梅垭口、飞来寺、猫鼻梁…)name
query_peaks按经纬度查周边可见雪山 + 当日日出/日落金山预报lat, lng, date?
forecast_peak某山峰未来 1-7 天预报peak, days?, viewpoint?, date?

数据与算法

  • 气象:Open-Meteo 云量(含低云)、降水概率、湿度、风速/阵风
  • 地形:DEM 高程 + 视线分析(判断某观景点能否看到该峰)
  • 金光时段:太阳高度角(Golden Hour)+ 当地时区
  • 评分:综合云量/低云/湿度/风,0-100

覆盖中国主要雪山与观景点(贡嘎山、四姑娘山、卡瓦格博、玉珠峰、慕士塔格……),并提供多语种山峰名检索。

自托管(Self-host)

本仓库是 MCP 接入层(约 100 行),需要自行准备一份看雪山 API:

bash
pip install -r requirements.txtKXS_API=http://127.0.0.1:3000 python3 mcp_server.py   # 默认监听 0.0.0.0:3999

环境变量:KXS_API(后端地址)· HOST / PORT(监听,生产建议 HOST=127.0.0.1 走反代)· KXS_TOOL_LOG(可选,设为文件路径则每次工具调用追加一行 JSONL:工具名/参数/来源 IP/耗时/成败,便于自建用量统计)· KXS_STATS_DB(可选,设为 SQLite 路径则每次调用在 toolcall 表写一行,字段同上,便于直接查询/做面板)。 两个都不设则完全不写盘。


English

Kanxueshan MCP — golden-hour sunrise/sunset visibility forecasts for snow mountains in China.

Ask your MCP client: "Can I see the golden light on Gongga Mountain from Zimei Pass this weekend?" It returns the golden-hour windows (sunrise/sunset), a 0-100 visibility score, weather factors (cloud cover, humidity, wind), and suggested viewpoints.

Hosted endpoint (no install, no API key):

https://www.yilong.art/mcp

Tools: search_peak(name) · query_peaks(lat, lng, date?) · forecast_peak(peak, days?, viewpoint?, date?)

Data: Open-Meteo weather + a terrain/viewshed engine (DEM, solar altitude, line-of-sight). Forecast responses are in Chinese; peak names accept both Chinese and English queries.

Web app: https://www.yilong.art ・ Setup guide: https://www.yilong.art/ai.html

License

TBD

Source: README.md at commit 54b859a

Tools

3

search_peak

搜索中国雪山,返回匹配的山峰及其观景点(子梅垭口、飞来寺、台怀镇等)。 参数 name: 山峰名关键词(贡嘎山、幺妹峰、卡瓦格博、慕士塔格等)。

Parametersnamerequired

query_peaks

按经纬度查询周边可见雪山及今日日照金山预报(金光时段、0-100 评分、天气因子)。 参数 lat/lng: WGS-84 十进制度坐标;date: YYYY-MM-DD,缺省今天。

Parameterslatrequiredlngrequireddate

forecast_peak

查询某山峰未来 N 天(1-7)的日照金山预报。 参数 peak: 山峰名;days: 预报天数;viewpoint: 观景点名(可选,如子梅垭口); date: 起始日期 YYYY-MM-DD,缺省今天。

Parametersdatedayspeakrequiredviewpoint

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.