Sunrise & Sunset Times

Sunrise & Sunset Times MCP サーバー

地球上のあらゆる場所、あらゆる日付について、日の出、日の入り、薄明、ゴールデンアワー、ブルーアワー、太陽の位置、月の出、月の入り、月相など、正確な太陽と月の時刻を AI アシスタントやエージェントに提供する無料のリモート MCP サーバーです。Sunrise-Sunset.org が提供しています。

https://api.sunrise-sunset.org/mcp

• API キーも登録も不要です。 URL をクライアントに追加して、質問するだけです。
• リモートです。 インストールも実行も不要です。認証不要の Streamable HTTP を使用します。
• 現地時間です。 時刻は、その場所のタイムゾーンにおける ISO 8601 形式で返されます。
• 白夜と極夜に対応しています。 各日について、通常、白夜、極夜のいずれかが示され、発生しないイベントは架空の時刻ではなく null になります。

目次

• 接続方法
• ツール
• 質問の例
• 結果の例
• curl で試す
• 制限事項とクレジット表記
• 質問と問題
• ライセンス

接続方法

Claude（claude.ai、デスクトップアプリ、モバイルアプリ）：Settings → Connectors → Add custom connector の順に選択し、上記の URL を貼り付けます。

Claude Code：

claude mcp add --transport http sunrise-sunset https://api.sunrise-sunset.org/mcp

ChatGPT： Settings → Apps & Connectors → Advanced settings → Developer mode の順に選択してから、URL をカスタムコネクターとして追加します。

Codex：

codex mcp add sunrise-sunset --url https://api.sunrise-sunset.org/mcp

Cursor： ~/.cursor/mcp.json、またはプロジェクト内の .cursor/mcp.json（mcp.json と同じ）に次の内容を追加します。

{ "mcpServers": { "sunrise-sunset": { "url": "https://api.sunrise-sunset.org/mcp" } } }

VS Code（GitHub Copilot のエージェントモード）：.vscode/mcp.json（configs/vscode-mcp.json と同じ）に次の内容を追加します。

{ "servers": { "sunrise-sunset": { "type": "http", "url": "https://api.sunrise-sunset.org/mcp" } } }

その他の MCP クライアントでも利用できます。認証不要で Streamable HTTP を使用する標準的なリモートサーバーです。詳しくはセットアップガイドをご覧ください。

ツール

どちらのツールも読み取り専用で、1 日分の同じ形式のオブジェクトを返します。

get_sun_times

1 か所、1 日分です。

パラメーター	必須	説明
lat	はい	緯度（十進度数）、-90～90。
lng	はい	経度（十進度数）、-180～180。
date	いいえ	today（デフォルト）、tomorrow、または YYYY-MM-DD。相対日付は、その場所の現地日付を基準にします。
tz	いいえ	Europe/Madrid などの IANA タイムゾーン。省略すると、座標に対応するタイムゾーンが使用されます（推奨）。

get_sun_times_range

1 か所、1 回の呼び出しで連続する最大 366 日分を取得できます。カレンダー、旅行、季節の比較などに使えます。日ごとに呼び出す必要はありません。

パラメーター	必須	説明
lat, lng, tz		上記と同じです。
date_start	はい	最初の日付、YYYY-MM-DD。
date_end	はい	最後の日付（この日を含む）、YYYY-MM-DD。

指定した日数より少ない日数が返される場合があります。そのタイムゾーンで存在しなかった暦日は除外されます（サモアは日付変更線を越えた際、2011 年 12 月 30 日を飛ばしました）。各項目は date フィールドで照合してください。

各日に含まれる内容

sunrise、sunset、solar_noon、day_length（秒）、sun_status（normal、midnight_sun、polar_night のいずれか）、市民薄明、航海薄明、天文薄明、dawn、dusk、first_light、last_light、golden_hour と blue_hour（朝と夕方）、日の出時と日の入り時の太陽方位角、正午の太陽高度、moonrise、moonset、moon_phase、moon_illumination。どちらのツールも outputSchema を宣言するため、クライアントやエージェントはすべてのフィールドと型を事前に把握できます。

質問の例

• 「サンフランシスコの明日のゴールデンアワーは何時ですか？」
• 「シアトルでは 11 月に日照時間がどれくらい短くなりますか？」
• 「2026 年 12 月のトロムソについて、毎日の日の出と日の入りを教えてください。」
• 「ユタ州モアブで、今月の星空観察に最も適した暗い夜はいつですか？」

結果の例

2026 年 12 月 24 日のリスボンにおける get_sun_times の結果（抜粋）：

{
  "date": "2026-12-24",
  "tzid": "Europe/Lisbon",
  "utc_offset": "+00:00",
  "lat": 38.72,
  "lng": -9.14,
  "sunrise": "2026-12-24T07:52:21+00:00",
  "sunset": "2026-12-24T17:19:57+00:00",
  "solar_noon": "2026-12-24T12:36:08+00:00",
  "day_length": 34056,
  "sun_status": "normal",
  "dawn": "2026-12-24T07:22:27+00:00",
  "dusk": "2026-12-24T17:49:51+00:00",
  "golden_hour": {
    "morning": { "begin": "2026-12-24T07:33:53+00:00", "end": "2026-12-24T08:34:15+00:00" },
    "evening": { "begin": "2026-12-24T16:38:04+00:00", "end": "2026-12-24T17:38:25+00:00" }
  },
  "moonrise": "2026-12-24T17:48:33+00:00",
  "moonset": "2026-12-24T08:29:49+00:00",
  "moon_phase": "Full Moon",
  "moon_illumination": 99.61
}

curl で試す

サーバーは POST 経由で JSON-RPC 2.0 を使用します。

curl -s https://api.sunrise-sunset.org/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_sun_times","arguments":{"lat":38.72,"lng":-9.14,"date":"2026-12-24"}}}'

プレーンな HTTP をお使いですか？ 同じデータを REST API でも利用できます。詳細は sunrise-sunset-org/api をご覧ください。

利用制限とクレジット表記

• 妥当な範囲であれば無料でご利用いただけます。同じ場所について複数日分のデータを取得する場合は、1 日ごとに呼び出すのではなく get_sun_times_range を使用してください。サーバーを短い間隔で繰り返し呼び出すクライアントは、一時的に HTTP 429 が返されることがあります。
• データを目にする人がいる場所では、クレジット表記が必要です。sunrise-sunset.org へのリンクを掲載するか、画面がない場合は Sunrise-Sunset.org に言及してください。詳細は API リポジトリをご覧ください。
• サーバーが停止していますか？ ステータスページをご確認ください。

質問と問題

issue を作成してください。使用しているクライアント、送信した内容、返された内容を記載してください。

サーバーの変更は API リポジトリのリリースで告知されます。 そこで Watch → Custom → Releases をクリックすると、通知を受け取れます。

ライセンス

このリポジトリ内のファイル（設定と例）は MIT License の下で公開されています。サーバーが返すデータには別途利用条件があります。上記のクレジット表記を行えば、無料でご利用いただけます。API ドキュメントをご覧ください。