MCP 服务器

mcp-ukrainian-calendar

Provides access to Ukrainian pagan calendar with holidays, deities, folk wisdom, and birth charms, enabling users to query today's holidays, upcoming events, deity details, and personal birth charms.

README

╔══════════════════════════════════════════════════════════════╗
║  ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦  ║
║  · ◆ ·       U K R A I N I A N   C A L E N D A R       · ◆ · ║
║  ✦ · ✦ ·           M C P   S E R V E R             · ✦ · ✦  ║
║  · ◆ · ◆ ·   ─────────────────────────────────   · ◆ · ◆ ·  ║
║  ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦  ║
╚══════════════════════════════════════════════════════════════╝

Ukrainian pagan calendar as an MCP server — holidays, deities, folk wisdom, and birth charms.

Сервер MCP з українським язичницьким календарем — свята, боги, народна мудрість, обереги.

</div>

Features


🗓 120 pagan holidays	Full calendar with traditions, rituals, and preparation guides
⚡ 184 deities	Ukrainian/Slavic pantheon from the Voytovych encyclopedia
🌾 365 folk wisdoms	Daily weather proverbs and agricultural sayings
🔮 8 birth charm periods	Personal patron deity based on your birthday
🇺🇦 Ukrainian language	All content in Ukrainian — authentic and unabridged
📦 Zero extra dependencies	Only the MCP SDK. No bloat.

Quick Start

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "ukrainian-calendar": {
      "command": "npx",
      "args": ["-y", "mcp-ukrainian-calendar"]
    }
  }
}

Claude Code (CLI)

claude mcp add ukrainian-calendar -- npx -y mcp-ukrainian-calendar

Cursor

Add to your Cursor MCP settings (~/.cursor/mcp.json):

{
  "mcpServers": {
    "ukrainian-calendar": {
      "command": "npx",
      "args": ["-y", "mcp-ukrainian-calendar"]
    }
  }
}

Tools

Tool	Description	Parameters
`get_today_holiday`	Holidays for today or a specific date, with traditions and rituals	`date?` — DD.MM format
`get_upcoming_holidays`	List of upcoming holidays in the next N days	`days?` — 1–365 (default 7)
`get_holiday_details`	Full details for a holiday by name or slug	`query` — name or slug
`search_holidays`	Search holidays by keyword across name, description, traditions	`query` — search text
`get_season_holidays`	All holidays for a given season	`season` — winter/spring/summer/autumn
`get_deity`	Info about a deity or mythological figure	`query` — name or slug
`search_deities`	Search deities by name or filter by group	`query?`, `group?`
`get_folk_wisdom`	Daily folk proverb for today or a specific date	`date?` — DD.MM format
`get_charm`	Personal birth charm with patron deity and ornament	`birthday` — DD.MM format

Deity groups: supreme · warrior · fertility · underworld · nature · household

Example Prompts

Holidays & Calendar

What Ukrainian pagan holidays are coming up this week?

Tell me about Купало — traditions, rituals, how to prepare.

What holidays are celebrated in Ukrainian paganism during winter?

Search for holidays related to fire in Ukrainian tradition.

Deities & Mythology

Who is Перун? Tell me about this deity.

List all deities of the underworld in Ukrainian mythology.

Who are the household deities in Slavic tradition?

Folk Wisdom & Charms

What does Ukrainian folk wisdom say about today's weather?

What is the folk proverb for March 25th?

I was born on 15.08 — what is my birth charm and patron deity?

Data Sources

All content is based on Valerii Voytovych's encyclopedic work on Ukrainian mythology, supplemented by traditional folk calendar materials. The deity database contains 184 figures from the Ukrainian/Slavic pantheon with descriptions faithful to the source.