English Français العربية

Sunshine Atlas MCP

مجتمعي أخرى

Monthly sunshine scores, temperatures, rainfall and sea temperatures for destinations: sunny-month rankings, when-to-visit lookups and comparisons.

الشيفرة المصدرية التوثيق

التثبيت

خطوات التثبيت موجودة في التوثيق أدناه. التوثيق

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Sunshine Atlas MCP server
  2. Tools
  3. Connect a client
  4. Self-host
  5. Data & methodology
  6. License

Sunshine Atlas MCP server

A remote, read-only Model Context Protocol server that answers "where is it sunny?" with data: monthly 0–100 Sunshine Scores, day/night temperatures, rainfall and sea temperature for 3,833 destinations — every one with its own airport — from long-term climate normals. It serves the same open dataset published at sunshineatlas.com/data (CC BY 4.0, DOI 10.5281/zenodo.21322408).

Live endpoint (no key, no signup):

https://sunshineatlas.com/api/mcp

Listed in the official MCP registry as com.sunshineatlas/sunshine-atlas. Docs page: sunshineatlas.com/mcp.

Tools

ToolAnswers
find_sunny_destinations"Where is it sunny (and warm) in November?" — ranked by that month's Sunshine Score, filterable by continent/country, minimum day temperature, swimmable sea (≥21 °C), population
get_destination_climate"When is the best time to visit Faro?" — full 12-month climate card for one destination (city, "city, country" or IATA code)
compare_destinations"Algarve or Crete in October?" — side-by-side comparison of 2–5 destinations with a one-line verdict

Every result carries attribution and citable sunshineatlas.com destination URLs.

Connect a client

Claude Code

claude mcp add --transport http sunshine-atlas https://sunshineatlas.com/api/mcp

Claude (custom connector), ChatGPT connectors, or any Streamable-HTTP client — add the URL https://sunshineatlas.com/api/mcp.

Generic JSON config (Cursor, etc.)

{
  "mcpServers": {
    "sunshine-atlas": {
      "url": "https://sunshineatlas.com/api/mcp"
    }
  }
}

Self-host

The server is a single stateless Node file (fresh McpServer per request, plain JSON responses, binds to 127.0.0.1 — put it behind your reverse proxy). It reads one dataset file and hot-reloads it on mtime change.

npm install
curl -O https://sunshineatlas.com/data/sunshine-atlas-destinations.json
PORT=8787 DATA_FILE=./sunshine-atlas-destinations.json node server.mjs

GET /healthz reports status and destination count. server.json is the MCP-registry manifest.

Data & methodology

  • Sunshine Score = 100 × warmth × (0.5 + 0.5 × (0.55 × dryness + 0.45 × sunniness)), computed from long-term climate normals — methodology.
  • Sources: temperature, rainfall and sunshine from NASA POWER climatology (2001–2020); places & populations from GeoNames & OurAirports; sea temperatures via Open-Meteo Marine.
  • Dataset: sunshineatlas.com/data · CSV/JSON · CC BY 4.0 · mirrors on GitHub, Hugging Face, Kaggle.

License

Code MIT. Data CC BY 4.0 (credit "Sunshine Atlas" + link). Not a forecast — climate normals describe typical conditions, not this week's weather.

الأسئلة الشائعة

ما هو Sunshine Atlas MCP؟

Monthly sunshine scores, temperatures, rainfall and sea temperatures for destinations: sunny-month rankings, when-to-visit lookups and comparisons.

كيف أثبّت Sunshine Atlas MCP؟

اتبع خطوات التثبيت في توثيقه المعروض في هذه الصفحة وفي مستودعه.

هل Sunshine Atlas MCP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Sunshine Atlas MCP؟

ينشره Flightmussy. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من القوائم المجتمعية awesome-mcp-servers ومستودع المشروع على GitHub. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.