Telugu Panchangam

本地服务

panchangam.astrochaganti.com生产力15 周前更新

代码仓库访问官网

关于 Telugu Panchangam

Telugu Panchangam 提供印度教历法、吉时、节日和行星信息的 MCP 工具，适用于按日期、城市或出生星规划活动，并涵盖多种计算体系及个人行运查询。

主要功能

01按日期和城市计算 Panchangam
02排序查找吉时
03列出节日和特殊日期
04为最多四人查找适宜日期
05查询日食、月食、行星位置和行运
06支持 Drik Ganita、Surya Siddhanta 和 Vakya 体系

适用场景

01查看指定城市的每日 Panchangam
02查找适合某项活动的日期和时段
03依据出生星规划吉日
04查看节日、日食月食或行星行运

MCP 相关

`mcp-server-panchangam` stdio 服务向兼容 MCP 的客户端和 Agent 提供历法、吉时、节日、天象及行运工具。

#panchangam #telugu #hindu-calendar #vedic-astrology #muhurta #festivals #calendar

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "telugu-calendar-utilities": {
      "command": "uvx",
      "args": [
        "mcp-server-panchangam"
      ]
    }
  }
}

启动命令uvx mcp-server-panchangam

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypimcp-server-panchangam1.6.2stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

泰卢固 Panchangam 日历订阅源

适用于 22 个城市、可订阅的泰卢固 Panchangam 订阅源——以 .ics 文件形式提供，可添加到 Google Calendar、Apple Calendar 或 Outlook。

每天都会显示为全天事件（不会占用日历时段），并在描述中提供完整的 Panchangam 详情。节日——Ugadi、Vinayaka Chavithi、Deepavali、Maha Shivaratri、Sankranti 节庆群以及另外 30 多个节日——会在标题中标记 🪔；其他特殊日子（Ekadashi、Amavasya、Pournami、Pradosham、Sankranti、日食和月食）则标记 ⚡。

该网站也是一套每日工具集：今日 Panchangam（任意日期、任意城市）、Tarabalam · Muhurtam （根据最多四人的出生星宿，提供吉日和按优先级排列的时段，并包含 Chandrabalam），以及 Gochara 图表与 Rasi Phalalu（南印度图表、行星过境判定和计算得出的每日解读）。访客还可以根据已知的占星信息创建仅保存在浏览器本地的个人档案。在本地开发环境和明确启用的公开构建中，可以根据日期、准确时间和出生地计算 Nakshatra、Padam、Janma Rashi、Lagna，并生成可供审核的 D1 图表。在获批许可计算服务和地点提供方之前，公开构建会默认拒绝计算；已保存的计算档案仍可查看。姓名不会离开浏览器。请参阅计算与隐私约定。 Drik Muhurtam 搜索还包含一个基于来源的候选时段图表筛选步骤，并由独立的默认拒绝标志保护。除非 VITE_ELECTION_CHART_API_ENABLED 的值严格为 true，否则公开构建不会发起图表请求；请参阅筛选方法与发布边界。所有内容都可以分享到 WhatsApp。

订阅流程示意

每日事件包含的内容

元数据 — Samvatsara、Maasam、Paksham、Vaaram、太阳和月亮星座
Pancha Anga — Tithi、Nakshatra、Yoga、Karana 及其开始／结束时间
天象标记 — 日出、日落、月出、月落
吉利时段 — Brahma Muhurta、Abhijit Muhurta、Amrita Kalam
不吉利时段 — Rahu Kalam、Gulika Kalam、Yamagandam、Varjyam、Durmuhurtham
Choghadiya — 8 个白天时段及其名称
日食和月食 — 提供类型（全食／偏食／环食／半影月食）、所在城市的可见情况、食甚时段和 Sutak 期间
特殊 Yoga — 根据星期、Tithi 和 Nakshatra 的组合，提供 Sarvartha Siddhi、Amrita Siddhi、Visha 和 Dagdha Yoga

城市

泰卢固核心地区 — Hyderabad、Vijayawada、Visakhapatnam、Tirupati、Warangal、Guntur、Nizamabad、Rajahmundry、Kurnool、Nellore

印度主要大都市 — Bengaluru、Chennai、Mumbai、Delhi

海外侨民聚居地 — Dallas、San Jose、San Francisco、Edison (NJ)、New York、London、Sydney、Dubai

计算体系

体系	依据	适用场景
Drik Ganita	Swiss Ephemeris (pyswisseph) — 支持 Lahiri、Raman、Krishnamurti、True Chitrapaksha ayanamsa	现代应用、精确天象事件
Surya Siddhanta	古典 SS 文本中的平运动算法	根植于古典 siddhanta 计算法的传统
Vakya	Surya Siddhanta + 已出版的修正表	传统泰卢固语／泰米尔语印刷版 Panchangam

MCP 服务

mcp-server-panchangam 可在 PyPI 上获取。它是一个标准的 MCP stdio 服务（uvx mcp-server-panchangam），因此可与任何兼容 MCP 的客户端或 Agent 配合使用——Claude Desktop、Claude Code、Cursor、Windsurf，以及基于 MCP SDK 构建的自定义 Agent。下面列出了几个常见客户端的示例；对于其他客户端，将客户端的 MCP 配置指向同一条 uvx mcp-server-panchangam 命令即可。

Claude Desktop — 添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

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

Claude Code — 运行一次：

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

可用工具

每日 Panchangam

工具	描述
`get_panchangam`	查询任意日期和城市的完整 Panchangam
`get_muhurta`	查询一天内的吉时／凶时（调用较轻量；跨多天搜索请使用 `find_muhurta`）
`get_panchanga_shuddhi`	五支纯净度判定（从 Sarva Shuddha 到 Sarva Ashuddha），附各支的质量和原因

跨多天规划

工具	描述
`get_panchangam_range`	汇总日期范围内每天的 Panchangam（最多 31 天）
`get_special_days`	查询一个月内的具名节日、Ekadashi、Amavasya、Pournami、Pradosham、Sankranti 和日月食
`find_muhurta`	按优先级排列的吉时时段——考虑活动类型，并说明每个时段的原因
`find_tarabalam_days`	Tarabalam 和 Chandrabalam——根据出生星宿（和 rashi）查询适合 1–4 人的日期

天象事件

工具	描述
`get_combustion_calendar`	水星、金星、火星、木星和土星的 Asta/Udaya（进入／退出燃烧期）时段
`get_graha_yuddha`	Graha Yuddha（行星战争）时段——胜者、败者及 UTC 时间
`get_rashi_ingresses`	日期范围内所有传统行星的 rashi 星座变更事件
`get_eclipse_calendar`	日食和月食，包括各城市的可见情况及 Sutak 时间

Gochara 和个人行运

工具	描述
`get_graha_positions`	日出时九大 graha 的位置——rasi、nakshatra、逆行状态及下次进入 rasi 的日期
`get_gochara`	从 janma rashi 推算的 Gochara 判定——宫位、vedha、Sade Sati／Ashtama Shani
`get_rasi_phalalu`	根据计算结果生成的确定性每日运势

日内时段

工具	描述
`get_daily_horas`	当天的 24 个行星时（horas），从日出开始，以当日星期主星为首
`get_lagna_transitions`	追踪全天东方地平线上升点（Lagna）星座的边界变化

实用工具

工具	描述
`list_supported_cities`	22 个预配置城市，包含纬度／经度／时区

所有工具都接受任意自由文本城市名称。预配置城市可即时解析；其他城市则通过 OpenStreetMap 进行地理编码。也可以直接传入 latitude、longitude 和 timezone。

接受 city 或日期参数的 Drik 系统工具也接受 ayanamsa=lahiri|raman|krishnamurti|true_chitrapaksha（默认值：lahiri）。完整 API 文档和参数详情：PyPI 上的 mcp-server-panchangam。

工作原理

每月 1 日通过 GitHub Actions 生成数据源，覆盖未来 18 个月。数据源以静态 .ics 文件的形式托管在 GitHub Pages 上——无需托管费用。

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

维护与路线图

当前维护队列位于 Telugu Calendar Utilities GitHub Project。使用其中链接的状态和优先级字段，查看已规划、进行中或待审核的事项。在 仓库 Issues 中提交缺陷和功能提案。

docs/tracking/ 下的 CSV 文件和阶段计划是保留的历史记录；它们并非另一个待办列表。

文档

本仓库是权威文档源。请先阅读**文档规范，了解当前参考资料、运维、决策和历史资料应存放的位置，然后通过计算参考索引**查看详细的系统概览。VitePress 会根据这些文件构建可搜索的呈现版本，存放在 /docs/；该版本只是可丢弃的展示产物，不能取代作为事实来源的本仓库。

许可证和对应源代码

本项目是根据 GNU Affero General Public License v3.0 or later 发布的自由软件。网站和 MCP 包的用户可以从本仓库获取完整的对应源代码，包括构建说明和测试。PySwissEph 和 Swiss Ephemeris 的直接依赖声明保留在 THIRD_PARTY_NOTICES.md 中。

本项目选择了 Swiss Ephemeris 双重许可模式中的 AGPL 许可路径。较早的副本仍适用随这些副本提供的许可条款；此版本不会撤回先前授予的许可。

开发

需要 Python 3.10+、uv 和 Node.js 24。

uv sync --locked --extra test --extra browser-test
uv run playwright install chromium
npm ci --ignore-scripts
uv run python tools/verify_project.py
uv run python -m telugu_panchangam.generate   # writes to feeds/

支持 Markdown

登录后评论