Panchangam

io.github.socraticsurge由 GitHub 账号 socraticsurge 发布v1.6.2更新于 Oct 27, 2026

Telugu Panchangam: tithi, nakshatra, muhurtas, festivals, tarabalam, gochara, daily rasi phalalu

已验证STDIO仅桌面位置与生活效率与工作流

概览

AI 生成的概览

本地 MCP 服务器,为助手提供泰卢固 Panchangam 数据:日期与城市的 tithi、nakshatra、muhurta、节日、tarabalam、gochara 及每日 rasi phalalu。

可以做什么
  • 获取某日某城的完整 Panchangam、吉凶时段或五支纯净度判定
  • 跨日规划:最多 31 天的区间摘要、每月节日与特殊日清单、按活动排序的吉时、最多四人的 tarabalam 与 chandrabalam 吉日
  • 查询天象:行星燃烧期、行星相战、星座换宫及按城市可见的日月食
  • 读取 gochara 行运、日出时九曜位置,以及由计算事实生成的每日 rasi phalalu
  • 获取日内时序:24 个行星时辰(horas)与上升星座(lagna)转换
  • 列出 22 个预置城市;其他城市会进行地理编码,也可直接传入经纬度与时区
适用场景
适合让助手回答泰卢固历法问题、为某项活动挑选吉时、围绕节日与日月食做安排,或结合出生星宿与星座查看行运,而无需另开网站。
运行要求
通过 uvx 从 PyPI 包 mcp-server-panchangam 以 stdio 方式在本机运行,需要 Python 与 uv。未声明任何认证、环境变量或请求头。22 个预置城市之外的城市会经 OpenStreetMap 地理编码,因此需要网络访问。
安装前请注意
输出属于基于传统历法的仪式性/占星性建议,并非经核实的事实或医疗意见。预置列表之外的自由文本城市名会发送至 OpenStreetMap 进行地理编码。tarabalam 与 gochara 所需的出生信息作为工具输入传入,请留意客户端是否记录这些内容。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Panchangam,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Telugu Panchangam Calendar Feeds

Subscribable Telugu Panchangam feeds for 22 cities — delivered as .ics files you can add to Google Calendar, Apple Calendar, or Outlook.

Every day appears as an all-day event (no calendar blocking) with full Panchangam details in the description. Festival days — Ugadi, Vinayaka Chavithi, Deepavali, Maha Shivaratri, the Sankranti cluster, and 30+ more — are marked with 🪔 in the title; other special days (Ekadashi, Amavasya, Pournami, Pradosham, Sankranti, Eclipses) with ⚡.

[Today's Panchangam at panchangam.astrochaganti.com]

Subscribe

Visit the landing page to pick your city and calculation system and copy your webcal:// URL:

panchangam.astrochaganti.com

The site is also a daily toolkit: Today's Panchangam (any date, any city), Tarabalam · Muhurtam (good days and ranked time slots for up to four people by birth star, with Chandrabalam), and the Gochara chart with Rasi Phalalu (South Indian chart, transit verdicts and a computed daily reading). Guests can also create browser-local profiles from known astrology details. Local development and an explicitly activated public build can calculate Nakshatra, Padam, Janma Rashi, Lagna, and a reviewable D1 chart from date, exact time, and birthplace. Public builds fail closed until the licensed calculation service and place provider are approved; saved calculated profiles remain viewable. The name never leaves the browser. See the calculation and privacy contract. Drik Muhurtam searches also contain a source-backed candidate-time chart post-screen, guarded by an independent fail-closed flag. Public builds make no chart request unless VITE_ELECTION_CHART_API_ENABLED is exactly true; see the screening method and release boundary. Everything is shareable to WhatsApp.

What subscribing looks like

[Subscribe flow — pick a feed, copy the webcal URL, add to your calendar]

What's in each day's event

  • Metadata — Samvatsara, Maasam, Paksham, Vaaram, solar and lunar signs
  • Pancha Anga — Tithi, Nakshatra, Yoga, Karana with start/end times
  • Sky markers — Sunrise, Sunset, Moonrise, Moonset
  • Auspicious windows — Brahma Muhurta, Abhijit Muhurta, Amrita Kalam
  • Inauspicious windows — Rahu Kalam, Gulika Kalam, Yamagandam, Varjyam, Durmuhurtham
  • Choghadiya — 8 day blocks with names
  • Eclipses — Solar and lunar eclipses with type (Total/Partial/Annular/Penumbral), visibility from your city, eclipse window, and Sutak period
  • Special Yogas — Sarvartha Siddhi, Amrita Siddhi, Visha, and Dagdha yogas based on weekday/tithi/nakshatra combination

Cities

Telugu Heartland — Hyderabad, Vijayawada, Visakhapatnam, Tirupati, Warangal, Guntur, Nizamabad, Rajahmundry, Kurnool, Nellore

Major Indian Metros — Bengaluru, Chennai, Mumbai, Delhi

International Diaspora — Dallas, San Jose, San Francisco, Edison (NJ), New York, London, Sydney, Dubai

Calculation Systems

SystemBasisBest for
Drik GanitaSwiss Ephemeris (pyswisseph) — supports Lahiri, Raman, Krishnamurti, True Chitrapaksha ayanamsasModern apps, accurate sky events
Surya SiddhantaMean-motion algorithms from classical SS textTraditions rooted in classical siddhantic calculation
VakyaSurya Siddhanta + published correction tablesTraditional Telugu/Tamil printed Panchangams

MCP Server

mcp-server-panchangam is available on PyPI. It's a standard MCP stdio server (uvx mcp-server-panchangam), so it works with any MCP-compatible client or agent — Claude Desktop, Claude Code, Cursor, Windsurf, and custom agents built on the MCP SDK. Below are examples for a couple of common clients; for others, point your client's MCP config at the same uvx mcp-server-panchangam command.

Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json:

json
{  "mcpServers": {    "panchangam": {      "command": "uvx",      "args": ["mcp-server-panchangam"]    }  }}

Claude Code — run once:

bash
claude mcp add panchangam -- uvx mcp-server-panchangam

Available tools

Daily Panchangam

ToolDescription
get_panchangamFull Panchangam for any date and city
get_muhurtaOne day's auspicious/inauspicious windows (lighter call; use find_muhurta to search across days)
get_panchanga_shuddhiFive-limb purity verdict (Sarva Shuddha → Sarva Ashuddha) with per-limb quality and reason

Planning across days

ToolDescription
get_panchangam_rangeCompact Panchangam summary for each day in a range (max 31 days)
get_special_daysNamed festivals, Ekadashi, Amavasya, Pournami, Pradosham, Sankranti, and Eclipses for a month
find_muhurtaRanked auspicious time slots — activity-aware, every slot with its reasons
find_tarabalam_daysTarabalam & Chandrabalam — days favourable for 1–4 people by birth star (and rashi)

Sky events

ToolDescription
get_combustion_calendarAsta/Udaya (combustion entry/exit) periods for Mercury, Venus, Mars, Jupiter, Saturn
get_graha_yuddhaGraha Yuddha (planetary war) periods — winner, loser, timing in UTC
get_rashi_ingressesAll rashi sign-change events for the classical planets over a date range
get_eclipse_calendarSolar and lunar eclipses with per-city visibility and Sutak timing

Gochara and personal transits

ToolDescription
get_graha_positionsAll nine grahas at sunrise — rasi, nakshatra, retrograde, next-rasi dates
get_gocharaGochara verdicts from a janma rashi — houses, vedha, Sade Sati / Ashtama Shani
get_rasi_phalaluDeterministic daily reading rendered from computed facts

Intraday timing

ToolDescription
get_daily_horas24 planetary hours (horas) for the day, starting at sunrise with the weekday lord
get_lagna_transitionsAscendant (Lagna) sign boundaries tracking the eastern horizon across the day

Utility

ToolDescription
list_supported_cities22 pre-configured cities with lat/lon/timezone

All tools accept any free-text city name. Pre-configured cities resolve instantly; any other city is geocoded via OpenStreetMap. You can also pass latitude, longitude, and timezone directly.

Drik-system tools that accept a city or date also accept ayanamsa=lahiri|raman|krishnamurti|true_chitrapaksha (default: lahiri). Full API documentation and parameter details: mcp-server-panchangam on PyPI.

How it works

Feeds are generated on the 1st of every month via GitHub Actions, covering 18 months ahead. They are served as static .ics files from GitHub Pages — zero hosting cost.

GitHub Actions (monthly cron)  → python -m telugu_panchangam.generate   (22 cities × 3 systems = 66 feeds)  → feeds/*.ics  → GitHub Pages (webcal:// subscriptions)

Maintenance and roadmap

The active maintenance queue is the Telugu Calendar Utilities GitHub Project. Use the linked status and priority fields to see what is planned, in progress, or ready for review. File defects and feature proposals in repository Issues.

The CSV files and phase plans under docs/tracking/ are preserved historical records; they are not a second backlog.

Documentation

The repository is the canonical documentation source. Start with the documentation standard for where current reference, operations, decisions, and historical material belong, then use the computation reference index for the detailed system map. A searchable VitePress projection is built from these files at /docs/; it is disposable presentation output and does not replace the repository as the source of truth.

License and corresponding source

Copyright (C) 2026 Vinay Chaganti.

This project is free software under the GNU Affero General Public License v3.0 or later. Users of the website and MCP package can obtain the complete corresponding source, including build instructions and tests, from this repository. Direct dependency notices for PySwissEph and Swiss Ephemeris are preserved in THIRD_PARTY_NOTICES.md.

This project selects the AGPL path in Swiss Ephemeris's dual-license model. Earlier copies remain available under the licence terms conveyed with those copies; this release does not withdraw an earlier grant.

Development

Requires Python 3.10+, uv, and Node.js 24.

bash
uv sync --locked --extra test --extra browser-testuv run playwright install chromiumnpm ci --ignore-scriptsuv run python tools/verify_project.pyuv run python -m telugu_panchangam.generate   # writes to feeds/

来源:README.md,提交 7c5ebfb

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.6.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分