MCP Hub
Back to servers

shirabe-calendar-api

Japanese calendar API for AI agents. Provides Rokuyo, Rekichu, Eto, 24 Solar Terms, and fortune judgments. MCP + REST API.

glama
Updated
Apr 15, 2026
View Source
Claim this server

Shirabe Calendar API

譌･譛ｬ縺ｮ證ｦ諠・ｱ・亥・譖懊・證ｦ豕ｨ繝ｻ蟷ｲ謾ｯ繝ｻ莠悟香蝗帷ｯ豌暦ｼ峨→逕ｨ騾泌挨蜷牙・蛻､螳壹ｒ霑斐☆ REST API + MCP 繧ｵ繝ｼ繝舌・縲・ AI繧ｨ繝ｼ繧ｸ繧ｧ繝ｳ繝茨ｼ・laude縲，hatGPT 遲会ｼ峨′逶ｴ謗･蜻ｼ縺ｳ蜃ｺ縺帙ｋ MCP 蟇ｾ蠢懊→縲√さ繝ｳ繝・く繧ｹ繝井ｻ倥″繝ｬ繧ｹ繝昴Φ繧ｹ縺檎音髟ｷ縺ｧ縺吶・

繧ｯ繧､繝・け繧ｹ繧ｿ繝ｼ繝・

1. API繧ｭ繝ｼ繧貞叙蠕・

shirabe.dev 縺ｧ繧｢繧ｫ繧ｦ繝ｳ繝医ｒ菴懈・縺励、PI繧ｭ繝ｼ繧貞叙蠕励＠縺ｦ縺上□縺輔＞・・ree 繝励Λ繝ｳ縺ｯ譛・,000繝ｪ繧ｯ繧ｨ繧ｹ繝医∪縺ｧ辟｡譁呻ｼ峨・

2. API繧貞他縺ｳ蜃ｺ縺・

# 謖・ｮ壽律縺ｮ證ｦ諠・ｱ繧貞叙蠕・curl -H "X-API-Key: shrb_your_api_key" \
  "https://api.shirabe.dev/api/v1/calendar/2026-11-15"

# 邨仙ｩ壼ｼ上↓譛驕ｩ縺ｪ譌･繧呈､懃ｴ｢
curl -H "X-API-Key: shrb_your_api_key" \
  "https://api.shirabe.dev/api/v1/calendar/best-days?purpose=wedding&start=2026-11-01&end=2027-03-31&limit=5"

# 譌･莉倡ｯ・峇縺ｮ螟ｧ螳峨ｒ荳諡ｬ蜿門ｾ・curl -H "X-API-Key: shrb_your_api_key" \
  "https://api.shirabe.dev/api/v1/calendar/range?start=2026-11-01&end=2026-11-30&filter_rokuyo=螟ｧ螳・

3. MCP 縺ｧ菴ｿ縺・ｼ・laude Desktop・・

譁ｹ豕・A: npm 繝代ャ繧ｱ繝ｼ繧ｸ・域耳螂ｨ・・

npm install -g @shirabe-api/calendar-mcp

claude_desktop_config.json 縺ｫ莉･荳九ｒ霑ｽ蜉:

{
  "mcpServers": {
    "shirabe-calendar": {
      "command": "npx",
      "args": ["-y", "@shirabe-api/calendar-mcp"],
      "env": {
        "SHIRABE_API_KEY": "shrb_your_api_key"
      }
    }
  }
}

譁ｹ豕・B: 繝ｪ繝｢繝ｼ繝・MCP 繧ｵ繝ｼ繝舌・・・RL 逶ｴ謗･謖・ｮ夲ｼ・

Streamable HTTP 蟇ｾ蠢懊・繧ｯ繝ｩ繧､繧｢繝ｳ繝医〒縺ｯ URL 繧堤峩謗･謖・ｮ壹〒縺阪∪縺・

{
  "mcpServers": {
    "shirabe-calendar": {
      "url": "https://shirabe.dev/mcp"
    }
  }
}

險ｭ螳壼ｾ後，laude 縺ｫ縲梧・譌･縺ｮ蜈ｭ譖懊・・溘阪梧擂譛医・邨仙ｩ壼ｼ上↓譛驕ｩ縺ｪ譌･縺ｯ・溘阪→閨槭￥縺縺代〒證ｦ諠・ｱ繧貞叙蠕励〒縺阪∪縺吶・

API 繧ｨ繝ｳ繝峨・繧､繝ｳ繝・

GET /api/v1/calendar/{date}

謖・ｮ壽律縺ｮ證ｦ諠・ｱ繧偵☆縺ｹ縺ｦ霑斐＠縺ｾ縺吶・

繝代Λ繝｡繝ｼ繧ｿ蝙・蠢・・隱ｬ譏・
datepath (YYYY-MM-DD)Yes蟇ｾ雎｡譌･莉・
categoriesquery (繧ｫ繝ｳ繝槫玄蛻・ｊ)No蜷牙・蛻､螳壹き繝・ざ繝ｪ・育怐逡･譎ゅ・蜈ｨ繧ｫ繝・ざ繝ｪ・・
langqueryNoja・医ョ繝輔か繝ｫ繝茨ｼ峨∪縺溘・ en

GET /api/v1/calendar/range

譌･莉倡ｯ・峇縺ｮ證ｦ諠・ｱ繧剃ｸ諡ｬ蜿門ｾ励＠縺ｾ縺吶・

繝代Λ繝｡繝ｼ繧ｿ蝙・蠢・・隱ｬ譏・
startquery (YYYY-MM-DD)Yes髢句ｧ区律
endquery (YYYY-MM-DD)Yes邨ゆｺ・律・域怙螟ｧ93譌･髢難ｼ・
filter_rokuyoqueryNo蜈ｭ譖懊ヵ繧｣繝ｫ繧ｿ・井ｾ・ `螟ｧ螳荏・・
filter_rekichuqueryNo證ｦ豕ｨ繝輔ぅ繝ｫ繧ｿ・井ｾ・ 螟ｩ襍ｦ譌･・・
categoryqueryNo繧ｫ繝・ざ繝ｪ繝輔ぅ繝ｫ繧ｿ・井ｾ・ wedding・・
min_scorequeryNo譛菴弱せ繧ｳ繧｢・・縲・0・・

GET /api/v1/calendar/best-days

謖・ｮ夂畑騾斐↓譛驕ｩ縺ｪ譌･繧偵Λ繝ｳ繧ｭ繝ｳ繧ｰ縺ｧ霑斐＠縺ｾ縺吶・

繝代Λ繝｡繝ｼ繧ｿ蝙・蠢・・隱ｬ譏・
purposequeryYes逕ｨ騾費ｼ・wedding/funeral/moving/construction/business/car_delivery/marriage_registration/travel`・・
startquery (YYYY-MM-DD)Yes髢句ｧ区律
endquery (YYYY-MM-DD)Yes邨ゆｺ・律・域怙螟ｧ365譌･髢難ｼ・
limitqueryNo霑斐☆莉ｶ謨ｰ・医ョ繝輔か繝ｫ繝・縲∵怙螟ｧ20・・
exclude_weekdaysqueryNo髯､螟匁屆譌･・井ｾ・ 譛・轣ｫ・・

GET /health

繝倥Ν繧ｹ繝√ぉ繝・け縲りｪ崎ｨｼ荳崎ｦ√・

繝ｬ繧ｹ繝昴Φ繧ｹ萓・

蜊俶律蜿門ｾ・

{
  "date": "2026-11-15",
  "wareki": "莉､蜥・蟷ｴ11譛・5譌･",
  "day_of_week": {
    "ja": "譌･譖懈律",
    "en": "Sunday"
  },
  "kyureki": {
    "year": 2026,
    "month": 10,
    "day": 1,
    "is_leap_month": false,
    "month_name": "逾樒┌譛・
  },
  "rokuyo": {
    "name": "螟ｧ螳・,
    "reading": "縺溘＞縺ゅｓ",
    "description": "邨よ律蜷峨ゆｸ・ｺ九↓濶ｯ縺・律",
    "time_slots": {
      "morning": "蜷・,
      "noon": "蜷・,
      "afternoon": "蜷・,
      "evening": "蜷・
    }
  },
  "kanshi": {
    "full": "荳呵ｾｰ",
    "jikkan": "荳・,
    "junishi": "霎ｰ",
    "junishi_animal": {
      "ja": "鮴・,
      "en": "Dragon"
    }
  },
  "nijushi_sekki": {
    "name": "遶句・",
    "reading": "繧翫▲縺ｨ縺・,
    "description": "蜀ｬ縺ｮ蟋九∪繧翫ょ・縺ｮ豌鈴・縺檎ｫ九■蟋九ａ繧矩・,
    "is_today": false
  },
  "rekichu": [
    {
      "name": "荳邊剃ｸ・肴律",
      "reading": "縺・■繧翫ｅ縺・∪繧薙・縺・・",
      "description": "蟋九ａ縺溘％縺ｨ縺御ｸ・阪↓閹ｨ繧峨・蜷画律縲る幕讌ｭ繝ｻ蜈･邀阪・遞ｮ縺ｾ縺阪↓譛驕ｩ",
      "type": "蜷・
    }
  ],
  "context": {
    "邨仙ｩ・: {
      "judgment": "螟ｧ蜷・,
      "note": "螟ｧ螳峨→荳邊剃ｸ・肴律縺碁㍾縺ｪ繧区怙濶ｯ縺ｮ譌･縲らｵよ律蜷峨・縺溘ａ譎る俣蟶ｯ縺ｮ蛻ｶ邏・ｂ縺ｪ縺・,
      "score": 10
    }
  },
  "summary": "螟ｧ螳峨→荳邊剃ｸ・肴律縺碁㍾縺ｪ繧句､ｧ螟臥ｸ∬ｵｷ縺ｮ濶ｯ縺・律縺ｧ縺吶らｵ仙ｩ壼ｼ上・蜈･邀阪・髢区･ｭ縺ｪ縺ｩ縲∵眠縺励＞縺薙→繧貞ｧ九ａ繧九・縺ｫ譛驕ｩ縺ｧ縺吶・
}

MCP 繝・・繝ｫ

Shirabe Calendar API 縺ｯ莉･荳九・3縺､縺ｮ MCP 繝・・繝ｫ繧貞・髢九＠縺ｦ縺・∪縺吶・

繝・・繝ｫ蜷・隱ｬ譏・
get_japanese_calendar謖・ｮ壽律縺ｮ證ｦ諠・ｱ・亥・譖懊・證ｦ豕ｨ繝ｻ蟷ｲ謾ｯ繝ｻ莠悟香蝗帷ｯ豌暦ｼ峨→蜷牙・蛻､螳壹ｒ蜿門ｾ・
find_best_days謖・ｮ夂畑騾斐↓譛驕ｩ縺ｪ譌･繧呈悄髢灘・縺九ｉ讀懃ｴ｢縺励※繝ｩ繝ｳ繧ｭ繝ｳ繧ｰ縺ｧ霑斐☆
get_calendar_range譌･莉倡ｯ・峇縺ｮ證ｦ諠・ｱ繧剃ｸ諡ｬ蜿門ｾ暦ｼ亥・譖懊・證ｦ豕ｨ縺ｧ繝輔ぅ繝ｫ繧ｿ蜿ｯ閭ｽ・・

譁咎≡繝励Λ繝ｳ

繝励Λ繝ｳ蜊倅ｾ｡繝ｪ繧ｯ繧ｨ繧ｹ繝・譛・繝ｬ繝ｼ繝亥宛髯・
Free辟｡譁呻ｼ域怦1,000蝗槭∪縺ｧ・・1,0001 req/s
Starter1蜀・蝗橸ｼ域怦1,000蝗槭∪縺ｧ辟｡譁呻ｼ・50,00010 req/s
Pro1蜀・蝗橸ｼ域怦1,000蝗槭∪縺ｧ辟｡譁呻ｼ・500,00050 req/s
Enterprise1蜀・蝗橸ｼ域怦1,000蝗槭∪縺ｧ辟｡譁呻ｼ・辟｡蛻ｶ髯・100 req/s

繝励Λ繝ｳ髢薙・蟾ｮ蛻･蛹悶・縲梧怦髢薙Μ繧ｯ繧ｨ繧ｹ繝井ｸ企剞縲阪→縲後Ξ繝ｼ繝亥宛髯舌阪〒陦後＞縺ｾ縺吶・

隱崎ｨｼ

縺吶∋縺ｦ縺ｮ API 繝ｪ繧ｯ繧ｨ繧ｹ繝医↓ X-API-Key 繝倥ャ繝繝ｼ縺悟ｿ・ｦ√〒縺呻ｼ・/health` 繧帝勁縺擾ｼ峨・

X-API-Key: shrb_a1b2c3d4e5f6...

繝ｬ繧ｹ繝昴Φ繧ｹ繝倥ャ繝繝ｼ縺ｫ繝ｬ繝ｼ繝亥宛髯先ュ蝣ｱ縺悟性縺ｾ繧後∪縺・

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 2026-05-01T00:00:00Z

繧ｨ繝ｩ繝ｼ繝ｬ繧ｹ繝昴Φ繧ｹ

{
  "error": {
    "code": "INVALID_DATE",
    "message": "Date must be in YYYY-MM-DD format and between 1873-01-01 and 2100-12-31",
    "details": { "received": "2026-13-01" }
  }
}
繧ｹ繝・・繧ｿ繧ｹ繧ｳ繝ｼ繝・隱ｬ譏・
400INVALID_DATE譌･莉伜ｽ｢蠑上′荳肴ｭ｣縲√∪縺溘・遽・峇螟・
401INVALID_API_KEYAPI繧ｭ繝ｼ縺檎┌蜉ｹ縺ｾ縺溘・譛ｪ謖・ｮ・
429RATE_LIMIT_EXCEEDED繝ｬ繝ｼ繝亥宛髯占ｶ・℃
500INTERNAL_ERROR繧ｵ繝ｼ繝舌・蜀・Κ繧ｨ繝ｩ繝ｼ

謚陦薙せ繧ｿ繝・け

  • 繝ｩ繝ｳ繧ｿ繧､繝: Cloudflare Workers
  • 繝輔Ξ繝ｼ繝繝ｯ繝ｼ繧ｯ: Hono
  • **險隱・*: TypeScript (strict mode)
  • MCP SDK: @modelcontextprotocol/sdk
  • **隱ｲ驥・*: Stripe Billing
  • KV: Cloudflare KV
  • **繝・せ繝・*: Vitest・・71繝・せ繝茨ｼ・

繝ｭ繝ｼ繧ｫ繝ｫ髢狗匱

# 萓晏ｭ倬未菫ゅう繝ｳ繧ｹ繝医・繝ｫ
pnpm install

# 髢狗匱繧ｵ繝ｼ繝舌・襍ｷ蜍・pnpm run dev

# 繝・せ繝亥ｮ溯｡・pnpm run test

# 蝙九メ繧ｧ繝・け
pnpm run typecheck

# npm 繝代ャ繧ｱ繝ｼ繧ｸ逕ｨ CLI 繝薙Ν繝・pnpm run build:cli

繝ｩ繧､繧ｻ繝ｳ繧ｹ

Proprietary. All rights reserved.

MCP 繧ｯ繝ｩ繧､繧｢繝ｳ繝磯｣謳ｺ縺ｮ繧ｵ繝ｳ繝励Ν繧ｳ繝ｼ繝峨・ MIT 繝ｩ繧､繧ｻ繝ｳ繧ｹ縺ｧ謠蝉ｾ帙＠縺ｾ縺吶・

Reviews

No reviews yet

Sign in to write a review