暦データ MCP サーバー

Claude などの AI アプリから、日本の暦を公式値と照合したデータで引けるようにする MCP（Model Context Protocol）サーバーです。旧暦・六曜・吉日・二十四節気（節入りの時刻も）・行事の日付・祝日・和暦・干支・九星・日の出入り・月食・六曜の時間帯・明六つ暮六つを、1926〜2080年の範囲で返します。無料で、登録は要りません。

接続先

https://bestcalendar.jp/mcp

Streamable HTTP（POST・JSON 応答）の、認証なし・読み取り専用のリモート MCP サーバーです。

Claude（Web・デスクトップアプリ）

Claude の設定（Customize）から「コネクタ（Connectors）」を開き、「＋」→「カスタムコネクタを追加（Add custom connector）」を選びます。
URL の欄に https://bestcalendar.jp/mcp を入れて追加します。サインインは要りません。
チャットで「今日の六曜は？」のように聞くと、Claude がこのサーバーのツールを使って答えます。

無料プランを含むすべてのプランで使えます（無料プランはカスタムコネクタ 1 つまで）。Team・Enterprise プランでは、先に組織のオーナーが組織の設定の「コネクタ」でこの URL を追加し、メンバーはコネクタの一覧から「接続」を選びます。Web とデスクトップアプリは同じ設定です（デスクトップの claude_desktop_config.json に書く必要はありません）。

Claude Code

claude mcp add --transport http bestcalendar-koyomi https://bestcalendar.jp/mcp

既定ではそのプロジェクトだけで使えます。すべてのプロジェクトで使うなら --scope user、リポジトリで共有するなら --scope project（.mcp.json に書かれます）を付けます。.mcp.json に直接書く場合:

{"mcpServers": {"bestcalendar-koyomi": {"type": "http", "url": "https://bestcalendar.jp/mcp"}}}

Cursor

~/.cursor/mcp.json（すべてのプロジェクト）か、プロジェクトの .cursor/mcp.json に書きます。

{"mcpServers": {"bestcalendar-koyomi": {"url": "https://bestcalendar.jp/mcp"}}}

VS Code（GitHub Copilot のエージェントモード）

プロジェクトの .vscode/mcp.json に書きます。ツールはエージェントモードで使えます。

{"servers": {"bestcalendar-koyomi": {"type": "http", "url": "https://bestcalendar.jp/mcp"}}}

そのほかの MCP クライアントでも、「リモート（Streamable HTTP）」「認証なし」で上の URL を指定すれば使えます。

接続方法の早見表

アプリごとの接続の置き場所
使うアプリ	開く・書く場所	目印
Claude（Web・デスクトップ）	設定のコネクタ →「カスタムコネクタを追加」	URL の欄にサーバーの URL
Claude Code	ターミナルで claude mcp add	--transport http（全プロジェクトは --scope user）
Cursor	~/.cursor/mcp.json か .cursor/mcp.json	mcpServers の url
VS Code（GitHub Copilot）	.vscode/mcp.json	servers の type と url

この表の見方は、自分が使うアプリの行を探し、「開く・書く場所」に上の接続先の URL を入れるだけです。どの行も、サインインや API キーは要りません。

使い方の例

つないだあと、次のように聞くと、AI が合うツールを選んで呼び出します。質問はそのまま打てます。答えは 2026〜2027 年の暦なので、いつ聞いても同じです。

「2027年6月の大安で、土日に当たる日を教えて」

使うツール: search_lucky_days

→ 6月5日（土）の1日です。

「2027年の春分の日は何月何日？」

使うツール: get_koyomi_entity

→ 3月21日（日）です。

「2027年1月1日の東京の日の出は何時？」

使うツール: get_sun_moon_times

→ 6時50分です（日本時間。国立天文台「各地のこよみ」と同じ定義）。

「2026年12月25日から10営業日後はいつ？」

使うツール: add_days

→ 2027年1月12日（火）です（土日と祝日を除いて数えます）。

「2027年の祝日と振替休日を全部教えて」

使うツール: list_holidays

→ 元日から始まる日付と名前の一覧が返ります（内閣府の公表値と照合済み）。

こんなことが聞けます

接続したあとは、ふつうの言葉で聞くだけです。AI が合うツールを選んで呼び出します。答えは2026年11月8日時点の実際の結果です。

「今日の六曜と旧暦は？」

get_koyomi_day {"date": "2026-11-08"}

→ 11月8日（日）は先勝・旧暦9月29日・一粒万倍日

「12月の大安で、土日に当たる日は？」

search_lucky_days {"start": "2026-12-01", "end": "2026-12-31", "kinds": ["大安"], "weekdays": ["土", "日"]}

→ 1日ある（12月27日（日））

「1990年生まれの干支と九星は？」

convert_wareki_eto {"year": 1990}

→ 平成2年、庚午（かのえうま）、一白水星（1月1日〜節分生まれは前の年の星）

「京都の今日の日の出と日の入りは？」

get_sun_moon_times {"date": "2026-11-08", "prefecture": "京都"}

→ 日の出 06:24・日の入り 16:57（京都府の代表地点）

「2026年の祝日と振替休日を全部」

list_holidays {"year": 2026}

→ 全18日（日付・名前つきの一覧）

ツール（16本）

get_koyomi_day（特定の日の暦）

指定した日の暦: 和暦・旧暦（閏月）・六曜・吉日・不成就日・二十四節気/雑節・日干支・月齢と朔弦望の時刻・祝日・月食・年と月の九星。国立天文台・内閣府の公表値と照合したデータ（1926〜2080年）。

search_lucky_days（期間の吉日検索）

期間（366日まで）の中から、六曜（大安・友引など）と吉日（一粒万倍日・天赦日・寅の日など）の条件に合う日を探す。曜日で絞る・不成就日を除くこともできる。結果は200件まで。

convert_wareki_eto（和暦・干支・九星）

西暦の年（1926〜2080）を和暦（改元の年は両方）・十干十二支・年の九星に、または日付を和暦・本命星・月命星に換算する。year か date のどちらかを指定。

get_sun_moon_times（日の出入り・月の出入り）

日の出・日の入り・月の出・月の入り・南中の時刻。指定した日・都道府県（47都道府県の代表地点）の日の出・南中・日の入りと、月の出・南中・月の入り（日本時間）。国立天文台「各地のこよみ」と同じ定義。

list_holidays（祝日）

国民の祝日・振替休日・国民の休日の一覧（内閣府の公表値と照合済み）。year（1926〜2080）か、start と end（366日まで）で指定。

get_solar_term_times（二十四節気の節入りの時刻）

二十四節気の節入りの日時（日本標準時。秒までと、分に四捨五入した値）。立春・春分・夏至・秋分・冬至などが何時何分か。year（1926〜2080）か、start と end（366日まで）で指定。国立天文台暦要項と照合済み。

get_moon_phases（新月・満月・上弦・下弦の瞬間）

朔（新月）・上弦・望（満月）・下弦の瞬間（日本標準時・秒まで）の一覧。year（1926〜2080）か、start と end（366日まで）で指定。国立天文台の暦要項と照合済み。

get_koyomi_entity（行事・節気・祝日・吉日の日付）

名前（例: 春分の日・土用の丑の日・十五夜・一粒万倍日・戌の日・不成就日・節分・彼岸）から、その年の日付・次はいつ・あと何日・定義・根拠を返す。二十四節気・雑節の名前（例: 秋分・春分・二百十日・春の彼岸入り）でも引ける。year を指定するとその年、from_date（省略時は今日）を指定すると次の日。

get_moon_events（月食・スーパームーン）

月食（皆既・部分・半影、日本での見え方と時刻）とスーパームーンの一覧。year（1926〜2080）か、start と end（366日まで）で指定。

get_rokuyo_hours（六曜の時間帯）

指定した日の六曜と、時間帯ごとの吉凶（例: 先勝は午前が吉、赤口は正午前後だけ吉）。暦注の慣行による。

get_old_time（明六つ・暮六つと昔の時刻）

日本時間の日時から、その日の明六つ・暮六つ（国立天文台の定義）と、不定時法の刻（暮六つ・暁九つなど）、十二辰刻（丑三つ時など）を返す。地点は都道府県（省略時は東京都）。

count_days（日数と営業日数）

2 つの日付の間の日数（開始日・終了日を含めるか選べる）と営業日数（土日祝を除く。定休の曜日・お盆・年末年始・個別の休業日と営業日も指定できる）。数え方は /tools/date-calculator と同じ。business_count_start: true のときは営業日数に開始日も数え、既定の false は開始日を数えない（ある月の営業日の数は、start を 1 日・end を末日にして business_count_start: true を指定した値）。

add_days（N 日後・N 営業日後）

日付の N 日後・N 日前、または N 営業日後・前（business: true。土日祝を除く。定休の曜日・お盆・年末年始・個別の指定も可）。基準日は数えない。n が負なら前（締め切りの逆算）。

check_business_day（営業日かどうか）

日付（または 62 日までの期間）が営業日か休みか（理由と祝日名）。1 日だけなら次の営業日・前の営業日も返す。休みの規則は既定で土日祝、定休の曜日・お盆・年末年始・個別の休業日と営業日を指定できる。

find_dates（条件で日付を探す）

期間（366日まで）の中から、条件に合う日を探す。条件は六曜・吉日（一粒万倍日・天赦日・不成就日など）・曜日・祝日・土日祝・二十四節気/雑節・新月/満月など・日干支（十干・十二支）。all（すべて）・any（どれか）・none（除く）で組み合わせ、offset_days で「翌日が満月」「前日が祝日」のようなずれも指定できる。例: 2027年の大安の土日で不成就日でない日。

answer（暦の質問に 1 回で答える）

日本語の質問 1 つ（例: 2027年4月の一粒万倍日はいつ？／2026年10月1日の六曜は？／2027年の夏至の時刻は？／1990年5月23日から20営業日後は？）に、答え・根拠の道具と引数・出典を 1 回で返す。規則で読むので、読めない質問には推測せず「読めませんでした」と聞き方の例を返す。

どの結果にも、出典（国立天文台・内閣府）、どう照合したか、データの版を付けて返します。AI が答えを書くときに、その根拠を示せるようにするためです。

質問が答えになるまでの仕組み

あなたがチャットで、ふつうの言葉で聞きます（例：「今日の六曜は？」）。
AI アプリが、上のツール一覧から合うものを選び、日付などの引数を決めます。
AI アプリが、接続先の URL へ POST で呼び出しを送ります（JSON-RPC 2.0 の tools/call）。
サーバーがサイトのページと同じ暦の関数で計算し、結果を JSON で返します。出典・照合の説明・その日のページの URL が付きます。
AI がその結果を読んで、文章で答えます。書き写しで間違えたときは、ページの URL で確かめられます。

サーバーは会話を覚えず、1回ごとの呼び出しに答えるだけです。

結果の読み方（項目の早見表）

いちばん使う「特定の日の暦」（get_koyomi_day）が返す項目です。右の列は2026年11月8日を引いたときの実際の値です。

get_koyomi_day の結果の項目と、2026年11月8日の値
項目	意味	2026年11月8日の値
`date`	日付（年-月-日）	2026-11-08
`weekday`	曜日	日
`wareki`	和暦	令和8年
`kyureki`	旧暦の年月日（閏月かどうかも）	旧暦9月29日
`rokuyo`	六曜	先勝
`lucky_days`	その日に当たる吉日の名前	一粒万倍日
`fujoju_bi`	不成就日かどうか	いいえ
`solar_terms`	その日にある二十四節気	なし
`day_kanshi`	日の干支	丙戌
`moon`	月齢。朔弦望の日はその種類と時刻（日本時間）	月齢 28.5・朔弦望の日ではない
`holiday`	祝日・振替休日の名前	なし
`lunar_eclipse`	その日の月食	なし
`supermoon`	スーパームーンの日かどうか	いいえ
`kyusei`	年・月の九星と、切り替わりの注記	年一白水星・月八白土星
`page_url`	その日のページの URL。値を目で確かめる先	https://bestcalendar.jp/2026/11/8
`sources`	出典の一覧（国立天文台・内閣府など）	国立天文台暦計算室、内閣府「国民の祝日について」、ベストカレンダー暦データ（1926〜2080年）
`verification`	何とどう照合したかの説明	朔弦望・二十四節気・日の出入は国立天文台（暦要項・各地のこよみ）の公表値と照合している（年ごとの golden テスト）。旧暦・六曜は国立天文台の朔と中気から作り、閏月も含めて公表値と照合している。2033年は暦法の協会勧告（閏11月）に従う。吉日（選日・暦注下段）は公式の正解表が無いため、成立規則を文献（国立国会図書館・国立天文台「節月」など）と照合し、日干支の60周期と節入りから実装と独立に再計算して一致を確かめている。国民の祝日・振替休日・国民の休日は内閣府の公表 CSV と全件照合している。祝日のデータは祝日法の施行日1948年7月20日から（1948年は秋分の日・文化の日・勤労感謝の日の3日。それより前の旧祭日は含まない）。年の九星は立春、月の九星は12の節入り（国立天文台の値）で切り替わる。公開早見表5つと別の出典の月盤で照合している。日の九星は流派差があるので扱わない。

この表の見方は、AI の答えの根拠をたどるときに、page_url の先のページの値と見比べることです。verification には、何と照合したかの説明が入ります。

データの正しさ

朔・二十四節気・日の出入りは国立天文台暦計算室の公表値と、国民の祝日は内閣府の公表値と照合しています。旧暦と六曜は国立天文台の朔と中気から作っています。吉日は公式の正解表が無いため、暦注の成立規則を文献と照合し、日干支と節入りから実装とは別に計算し直して一致を確かめています。九星は年と月だけを扱います（日の九星は流派で違うため扱いません）。

利用条件

無料です。ログインも登録も API キーも要りません。読み取り専用で、サーバーのデータを書き換えることはありません。
引ける暦は 1926〜2080年です。
期間の指定は 366 日まで、検索の結果は 200 件までです。
ツールの呼び出しは、1 つの接続元につき 1 分に 60 回、1 日に 3,000 回までです（接続の手続きやツール一覧の取得は数えません）。サーバー全体では 1 分に 600 回まで、同時に処理するのは 2 件までです。超えたときは、少し待つようお返事します。1 日の上限は日本時間の 0 時に戻ります。
Claude（Web・デスクトップ）のコネクタは、多くの利用者が同じ接続元を共有します。混み合う時間帯は上限に届いて一時的に使えないことがあります。Claude Code など手元から接続するアプリは、それぞれの接続元で数えます。
AI の回答や文章で使うときは、出典（ベストカレンダー、および結果に付く国立天文台・内閣府）を示してください。
無保証です。内容の正しさも、いつでも使えることも保証しません。予告なく変えたり止めたりすることがあります。
仕事で使う場合や、まとめて取得・再配布・自社のサービスへの組み込み、回数の多い使い方は、法人向けの暦データ・APIをご利用ください。公開の回数の上限がなく、専用の API キーを使う法人向け MCPもあります。

記録と個人情報

サーバーを守り、不具合を調べるために、サーバーのログに次を記録します。

接続元の IP アドレス
呼ばれたツールの名前
結果の状態（成功か失敗か）と、かかった時間
接続した AI アプリの名前（接続のときに、アプリが名乗る名前）

質問の文章や、ツールに渡した日付・地名などの引数は記録しません。ログインがないので、お名前やメールアドレスも持ちません。

ログは 30 日たつと自動で消えます。使うのは、回数の制限・不正な使い方の防止・不具合の調査・どのアプリから使われているかの集計だけです。詳しくはプライバシーポリシーをご覧ください。

動くかどうかの確かめ方（開発者向け）

ターミナルから 1 回呼ぶと、サーバーの情報が JSON で返ります。

curl -s https://bestcalendar.jp/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"check","version":"1"}}}'

応答はいつも JSON で、セッションは持ちません（Mcp-Session-Id を出しません）。ブラウザで開くと 405 になるのは正常です（POST だけを受けます）。

よくある質問

料金や登録は要りますか？: 要りません。無料で、アカウントも API キーもありません。
どの年の暦を引けますか？: 1926年1月1日から2080年12月31日までです。国民の祝日は 1948 年 7 月 20 日（祝日法の施行日）からです（1948 年は秋分の日・文化の日・勤労感謝の日の 3 日、1949 年以降は 1 年を通してそろいます）。
「回数の上限です」と返ってきました。: 1 つの接続元からの呼び出しが、1 分に 60 回、または 1 日に 3,000 回を超えたときの返事です。書かれている秒数だけ待ってからお試しください。1 日の上限は日本時間の 0 時に戻ります。
AI の答えと、このサイトのページの値が違います。: AI が結果を書き写すときに間違えることがあります。日付を指定した結果には、その日のページの URL（page_url）が付いています。ページの値で確かめてください。
法人向けの API キーはどう送りますか？: リクエストの Authorization ヘッダに Bearer <API キー> を付けます。Claude Code なら claude mcp add --transport http bestcalendar-koyomi https://bestcalendar.jp/mcp --header "Authorization: Bearer <API キー>"、Cursor なら設定の headers に書きます。Claude（Web・デスクトップ）のカスタムコネクタは決まったキーを送れないので、キーを使うときは Claude Code など手元のアプリからつないでください。法人向けの契約は法人向け MCPをご覧ください。
商用のアプリやサービスに組み込めますか？: AI の回答の中で使うのは自由です（出典を示してください）。自社のサービスへの組み込み・一括取得・再配布は、法人向けの暦データ・APIをご覧ください。

問い合わせ

使い方の質問、不具合の連絡、提供についてのご相談は、問い合わせからお送りください。法人向けの契約は法人向け MCPをご覧ください。

2026年11月8日現在の情報です（データ最終更新: 2026年10月25日）。出典: 国立天文台暦計算室 / 内閣府「国民の祝日について」