ベストカレンダー 暦データ
Japanese calendar data (rokuyo, lucky days, solar terms, holidays, moon, sunrise), 1926-2080.
使うべきか
品質と安全性
検出事項(10)
- LOWget_koyomi_day 内
- LOWsearch_lucky_days 内
- LOWconvert_wareki_eto 内
- LOWget_sun_moon_times 内
- LOWget_koyomi_entity 内
- LOWget_rokuyo_hours 内
- LOWget_old_time 内
- LOWadd_days 内
- LOWcheck_business_day 内
- LOWanswer 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"koyomi": {
"url": "https://bestcalendar.jp/mcp"
}
}
}リモートエンドポイント
https://bestcalendar.jp/mcpstreamable-httpできること
ツール一覧
ツール(16)
🟢get_koyomi_day(date)
指定した日の暦: 和暦・旧暦(閏月)・六曜・吉日・不成就日・二十四節気/雑節・日干支・月齢と朔弦望の時刻・祝日・月食・年と月の九星。国立天文台・内閣府の公表値と照合したデータ(1926〜2080年)。
入力スキーマ
{
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
}
},
"required": [
"date"
],
"additionalProperties": false
}🟢search_lucky_days(start, end, kinds, match, weekdays, ...)
期間(366日まで)の中から、六曜(大安・友引など)と吉日(一粒万倍日・天赦日・寅の日など)の条件に合う日を探す。曜日で絞る・不成就日を除くこともできる。結果は200件まで。
入力スキーマ
{
"type": "object",
"properties": {
"start": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"end": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"kinds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "大安 友引 先勝 先負 仏滅 赤口 一粒万倍日 天赦日 神吉日 大明日 天恩日 母倉日 月徳日 寅の日 巳の日 己巳の日 不成就日"
},
"match": {
"type": "string",
"enum": [
"any",
"all"
],
"description": "any=どれかに当たる日(既定)、all=すべてに当たる日"
},
"weekdays": {
"type": "array",
"items": {
"type": "string",
"enum": [
"月",
"火",
"水",
"木",
"金",
"土",
"日"
]
},
"description": "曜日で絞る(例: [\"土\", \"日\"])"
},
"exclude_fujoju": {
"type": "boolean",
"description": "不成就日を除く"
}
},
"required": [
"start",
"end",
"kinds"
],
"additionalProperties": false
}🟢convert_wareki_eto(year, date)
西暦の年(1926〜2080)を和暦(改元の年は両方)・十干十二支・年の九星に、または日付を和暦・本命星・月命星に換算する。year か date のどちらかを指定。
入力スキーマ
{
"type": "object",
"properties": {
"year": {
"type": "integer",
"minimum": 1926,
"maximum": 2080
},
"date": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
}
},
"additionalProperties": false
}🟢get_sun_moon_times(date, prefecture)
日の出・日の入り・月の出・月の入り・南中の時刻。指定した日・都道府県(47都道府県の代表地点)の日の出・南中・日の入りと、月の出・南中・月の入り(日本時間)。国立天文台「各地のこよみ」と同じ定義。
入力スキーマ
{
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"prefecture": {
"type": "string",
"description": "都道府県名(例: 東京都・大阪府・北海道)"
}
},
"required": [
"date",
"prefecture"
],
"additionalProperties": false
}🟢list_holidays(year, start, end)
国民の祝日・振替休日・国民の休日の一覧(内閣府の公表値と照合済み)。year(1926〜2080)か、start と end(366日まで)で指定。
入力スキーマ
{
"type": "object",
"properties": {
"year": {
"type": "integer",
"minimum": 1926,
"maximum": 2080
},
"start": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"end": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
}
},
"additionalProperties": false
}🟢get_solar_term_times(year, start, end)
二十四節気の節入りの日時(日本標準時。秒までと、分に四捨五入した値)。立春・春分・夏至・秋分・冬至などが何時何分か。year(1926〜2080)か、start と end(366日まで)で指定。国立天文台 暦要項と照合済み。
入力スキーマ
{
"type": "object",
"properties": {
"year": {
"type": "integer",
"minimum": 1926,
"maximum": 2080
},
"start": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"end": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
}
},
"additionalProperties": false
}🟢get_moon_phases(year, start, end)
朔(新月)・上弦・望(満月)・下弦の瞬間(日本標準時・秒まで)の一覧。year(1926〜2080)か、start と end(366日まで)で指定。国立天文台の暦要項と照合済み。
入力スキーマ
{
"type": "object",
"properties": {
"year": {
"type": "integer",
"minimum": 1926,
"maximum": 2080
},
"start": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"end": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
}
},
"additionalProperties": false
}🟢get_koyomi_entity(name, year, from_date)
名前(例: 春分の日・土用の丑の日・十五夜・一粒万倍日・戌の日・不成就日・節分・彼岸)から、その年の日付・次はいつ・あと何日・定義・根拠を返す。二十四節気・雑節の名前(例: 秋分・春分・二百十日・春の彼岸入り)でも引ける。year を指定するとその年、from_date(省略時は今日)を指定すると次の日。
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "名前・読み・別名・slug"
},
"year": {
"type": "integer",
"minimum": 1926,
"maximum": 2080
},
"from_date": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
}
},
"required": [
"name"
],
"additionalProperties": false
}🟢get_moon_events(year, start, end)
月食(皆既・部分・半影、日本での見え方と時刻)とスーパームーンの一覧。year(1926〜2080)か、start と end(366日まで)で指定。
入力スキーマ
{
"type": "object",
"properties": {
"year": {
"type": "integer",
"minimum": 1926,
"maximum": 2080
},
"start": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"end": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
}
},
"additionalProperties": false
}🟢get_rokuyo_hours(date)
指定した日の六曜と、時間帯ごとの吉凶(例: 先勝は午前が吉、赤口は正午前後だけ吉)。暦注の慣行による。
入力スキーマ
{
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
}
},
"required": [
"date"
],
"additionalProperties": false
}🟢get_old_time(datetime, prefecture)
日本時間の日時から、その日の明六つ・暮六つ(国立天文台の定義)と、不定時法の刻(暮六つ・暁九つ など)、十二辰刻(丑三つ時 など)を返す。地点は都道府県(省略時は東京都)。
入力スキーマ
{
"type": "object",
"properties": {
"datetime": {
"type": "string",
"description": "YYYY-MM-DDTHH:MM(日本時間)"
},
"prefecture": {
"type": "string",
"description": "都道府県名(省略時は東京都)"
}
},
"required": [
"datetime"
],
"additionalProperties": false
}🟢count_days(start, end, include_start, include_end, business_count_start, ...)
2 つの日付の間の日数(開始日・終了日を含めるか選べる)と営業日数(土日祝を除く。定休の曜日・お盆・年末年始・個別の休業日と営業日も指定できる)。数え方は /tools/date-calculator と同じ。business_count_start: true のときは営業日数に開始日も数え、既定の false は開始日を数えない(ある月の営業日の数は、start を 1 日・end を末日にして business_count_start: true を指定した値)。
入力スキーマ
{
"type": "object",
"properties": {
"start": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"end": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"include_start": {
"type": "boolean",
"description": "日数に開始日を含める(既定 true)"
},
"include_end": {
"type": "boolean",
"description": "日数に終了日を含める(既定 false)"
},
"business_count_start": {
"type": "boolean",
"description": "営業日数に開始日も数える(既定 false)"
},
"closed_weekdays": {
"type": "array",
"items": {
"type": "string",
"enum": [
"月",
"火",
"水",
"木",
"金",
"土",
"日"
]
},
"description": "定休の曜日(既定は [\"土\", \"日\"]。空の配列なら曜日では休まない)"
},
"close_holidays": {
"type": "boolean",
"description": "祝日(振替休日・国民の休日を含む)を休む(既定 true)"
},
"obon": {
"type": "boolean",
"description": "お盆 8/13〜16 を休む(既定 false)"
},
"nenmatsu": {
"type": "boolean",
"description": "年末年始 12/29〜1/3 を休む(既定 false)"
},
"closed_dates": {
"type": "array",
"items": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"maxItems": 366,
"description": "個別の休業日"
},
"open_dates": {
"type": "array",
"items": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"maxItems": 366,
"description": "個別の営業日(祝日や定休日でも営業する日)"
}
},
"required": [
"start",
"end"
],
"additionalProperties": false
}🟢add_days(date, n, business, closed_weekdays, close_holidays, ...)
日付の N 日後・N 日前、または N 営業日後・前(business: true。土日祝を除く。定休の曜日・お盆・年末年始・個別の指定も可)。基準日は数えない。n が負なら前(締め切りの逆算)。
入力スキーマ
{
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"n": {
"type": "integer",
"minimum": -56613,
"maximum": 56613,
"description": "日数(負なら前)。暦日は 1926〜2080 年の範囲に収まる限り何日でも、営業日は ±2000(暦日 3,000 日まで進む)"
},
"business": {
"type": "boolean",
"description": "営業日で数える(既定 false)"
},
"closed_weekdays": {
"type": "array",
"items": {
"type": "string",
"enum": [
"月",
"火",
"水",
"木",
"金",
"土",
"日"
]
},
"description": "定休の曜日(既定は [\"土\", \"日\"]。空の配列なら曜日では休まない)"
},
"close_holidays": {
"type": "boolean",
"description": "祝日(振替休日・国民の休日を含む)を休む(既定 true)"
},
"obon": {
"type": "boolean",
"description": "お盆 8/13〜16 を休む(既定 false)"
},
"nenmatsu": {
"type": "boolean",
"description": "年末年始 12/29〜1/3 を休む(既定 false)"
},
"closed_dates": {
"type": "array",
"items": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"maxItems": 366,
"description": "個別の休業日"
},
"open_dates": {
"type": "array",
"items": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"maxItems": 366,
"description": "個別の営業日(祝日や定休日でも営業する日)"
}
},
"required": [
"date",
"n"
],
"additionalProperties": false
}🟢check_business_day(date, start, end, closed_weekdays, close_holidays, ...)
日付(または 62 日までの期間)が営業日か休みか(理由と祝日名)。1 日だけなら次の営業日・前の営業日も返す。休みの規則は既定で土日祝、定休の曜日・お盆・年末年始・個別の休業日と営業日を指定できる。
入力スキーマ
{
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"start": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"end": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"closed_weekdays": {
"type": "array",
"items": {
"type": "string",
"enum": [
"月",
"火",
"水",
"木",
"金",
"土",
"日"
]
},
"description": "定休の曜日(既定は [\"土\", \"日\"]。空の配列なら曜日では休まない)"
},
"close_holidays": {
"type": "boolean",
"description": "祝日(振替休日・国民の休日を含む)を休む(既定 true)"
},
"obon": {
"type": "boolean",
"description": "お盆 8/13〜16 を休む(既定 false)"
},
"nenmatsu": {
"type": "boolean",
"description": "年末年始 12/29〜1/3 を休む(既定 false)"
},
"closed_dates": {
"type": "array",
"items": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"maxItems": 366,
"description": "個別の休業日"
},
"open_dates": {
"type": "array",
"items": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"maxItems": 366,
"description": "個別の営業日(祝日や定休日でも営業する日)"
}
},
"additionalProperties": false
}🟢find_dates(start, end, all, any, none)
期間(366日まで)の中から、条件に合う日を探す。条件は六曜・吉日(一粒万倍日・天赦日・不成就日 など)・曜日・祝日・土日祝・二十四節気/雑節・新月/満月など・日干支(十干・十二支)。all(すべて)・any(どれか)・none(除く)で組み合わせ、offset_days で「翌日が満月」「前日が祝日」のようなずれも指定できる。例: 2027年の大安の土日で不成就日でない日。
入力スキーマ
{
"type": "object",
"properties": {
"start": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"end": {
"type": "string",
"description": "YYYY-MM-DD(1926-01-01〜2080-12-31)"
},
"all": {
"type": "array",
"items": {
"type": "object",
"description": "条件 1 つ。rokuyo・lucky_day・weekday・holiday・day_off・solar_term・moon_phase・day_kanshi・day_stem・day_branch のどれか 1 つと、任意の offset_days(-31〜31)",
"properties": {
"rokuyo": {
"type": "string",
"enum": [
"大安",
"友引",
"先勝",
"先負",
"仏滅",
"赤口"
]
},
"lucky_day": {
"type": "string",
"description": "一粒万倍日・天赦日・神吉日・大明日・天恩日・母倉日・月徳日・寅の日・巳の日・己巳の日・不成就日"
},
"weekday": {
"type": "string",
"enum": [
"月",
"火",
"水",
"木",
"金",
"土",
"日"
]
},
"holiday": {
"type": "boolean",
"description": "true で祝日・振替休日・国民の休日"
},
"day_off": {
"type": "boolean",
"description": "true で土日または祝日"
},
"solar_term": {
"type": "string",
"description": "二十四節気・雑節の名前(春分・夏の土用・節分 など)、または「二十四節気」「雑節」"
},
"moon_phase": {
"type": "string",
"enum": [
"新月",
"上弦の月",
"満月",
"下弦の月"
]
},
"day_kanshi": {
"type": "string",
"description": "日干支(例: 甲子)"
},
"day_stem": {
"type": "string",
"enum": [
"甲",
"乙",
"丙",
"丁",
"戊",
"己",
"庚",
"辛",
"壬",
"癸"
]
},
"day_branch": {
"type": "string",
"enum": [
"子",
"丑",
"寅",
"卯",
"辰",
"巳",
"午",
"未",
"申",
"酉",
"戌",
"亥"
],
"description": "十二支(戌 なら戌の日)"
},
"offset_days": {
"type": "integer",
"minimum": -31,
"maximum": 31,
"description": "1 なら翌日、-1 なら前日がその条件"
}
},
"additionalProperties": false
},
"description": "条件の配列(all・any・none を合わせて 12 個まで)"
},
"any": {
"type": "array",
"items": {
"type": "object",
"description": "条件 1 つ。rokuyo・lucky_day・weekday・holiday・day_off・solar_term・moon_phase・day_kanshi・day_stem・day_branch のどれか 1 つと、任意の offset_days(-31〜31)",
"properties": {
"rokuyo": {
"type": "string",
"enum": [
"大安",
"友引",
"先勝",
"先負",
"仏滅",
"赤口"
]
},
"lucky_day": {
"type": "string",
"description": "一粒万倍日・天赦日・神吉日・大明日・天恩日・母倉日・月徳日・寅の日・巳の日・己巳の日・不成就日"
},
"weekday": {
"type": "string",
"enum": [
"月",
"火",
"水",
"木",
"金",
"土",
"日"
]
},
"holiday": {
"type": "boolean",
"description": "true で祝日・振替休日・国民の休日"
},
"day_off": {
"type": "boolean",
"description": "true で土日または祝日"
},
"solar_term": {
"type": "string",
"description": "二十四節気・雑節の名前(春分・夏の土用・節分 など)、または「二十四節気」「雑節」"
},
"moon_phase": {
"type": "string",
"enum": [
"新月",
"上弦の月",
"満月",
"下弦の月"
]
},
"day_kanshi": {
"type": "string",
"description": "日干支(例: 甲子)"
},
"day_stem": {
"type": "string",
"enum": [
"甲",
"乙",
"丙",
"丁",
"戊",
"己",
"庚",
"辛",
"壬",
"癸"
]
},
"day_branch": {
"type": "string",
"enum": [
"子",
"丑",
"寅",
"卯",
"辰",
"巳",
"午",
"未",
"申",
"酉",
"戌",
"亥"
],
"description": "十二支(戌 なら戌の日)"
},
"offset_days": {
"type": "integer",
"minimum": -31,
"maximum": 31,
"description": "1 なら翌日、-1 なら前日がその条件"
}
},
"additionalProperties": false
},
"description": "条件の配列(all・any・none を合わせて 12 個まで)"
},
"none": {
"type": "array",
"items": {
"type": "object",
"description": "条件 1 つ。rokuyo・lucky_day・weekday・holiday・day_off・solar_term・moon_phase・day_kanshi・day_stem・day_branch のどれか 1 つと、任意の offset_days(-31〜31)",
"properties": {
"rokuyo": {
"type": "string",
"enum": [
"大安",
"友引",
"先勝",
"先負",
"仏滅",
"赤口"
]
},
"lucky_day": {
"type": "string",
"description": "一粒万倍日・天赦日・神吉日・大明日・天恩日・母倉日・月徳日・寅の日・巳の日・己巳の日・不成就日"
},
"weekday": {
"type": "string",
"enum": [
"月",
"火",
"水",
"木",
"金",
"土",
"日"
]
},
"holiday": {
"type": "boolean",
"description": "true で祝日・振替休日・国民の休日"
},
"day_off": {
"type": "boolean",
"description": "true で土日または祝日"
},
"solar_term": {
"type": "string",
"description": "二十四節気・雑節の名前(春分・夏の土用・節分 など)、または「二十四節気」「雑節」"
},
"moon_phase": {
"type": "string",
"enum": [
"新月",
"上弦の月",
"満月",
"下弦の月"
]
},
"day_kanshi": {
"type": "string",
"description": "日干支(例: 甲子)"
},
"day_stem": {
"type": "string",
"enum": [
"甲",
"乙",
"丙",
"丁",
"戊",
"己",
"庚",
"辛",
"壬",
"癸"
]
},
"day_branch": {
"type": "string",
"enum": [
"子",
"丑",
"寅",
"卯",
"辰",
"巳",
"午",
"未",
"申",
"酉",
"戌",
"亥"
],
"description": "十二支(戌 なら戌の日)"
},
"offset_days": {
"type": "integer",
"minimum": -31,
"maximum": 31,
"description": "1 なら翌日、-1 なら前日がその条件"
}
},
"additionalProperties": false
},
"description": "条件の配列(all・any・none を合わせて 12 個まで)"
}
},
"required": [
"start",
"end"
],
"additionalProperties": false
}🟢answer(question)
日本語の質問 1 つ(例: 2027年4月の一粒万倍日はいつ?/2026年10月1日の六曜は?/2027年の夏至の時刻は?/1990年5月23日から20営業日後は?)に、答え・根拠の道具と引数・出典を 1 回で返す。規則で読むので、読めない質問には推測せず「読めませんでした」と聞き方の例を返す。
入力スキーマ
{
"type": "object",
"properties": {
"question": {
"type": "string",
"maxLength": 300,
"description": "暦についての質問(日本語・300 文字まで)"
}
},
"required": [
"question"
],
"additionalProperties": false
}コミュニティ
エビデンス