vedicchart

Name: vedicchart
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords游戏娱乐01 周前更新

代码仓库

关于 vedicchart

vedicchart 是供需要访问托管吠陀占星服务的 MCP 客户端使用的本地 stdio 桥接工具。它转发命盘、日历、配对、dosha 等请求，本地不实现占星计算。

主要功能

01访问 17 项托管占星工具
02获取 Panchang 和出生星盘
03检查配对与 dosha
04查询大运与行星过境
05获取节日和日食日历

适用场景

01查询某地当天的 Panchang
02生成或查看出生星盘
03比较两张星盘的匹配度
04查询年度节日和日食

MCP 相关

它通过 stdio 在本地提供托管服务的工具列表，并将 MCP 工具调用转发至托管端点，再将结果返回客户端。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-vedicchart": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/vedicchart"
      ]
    }
  }
}

启动命令npx -y @reneturcios/vedicchart

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

安装包

npm@reneturcios/vedicchart0.1.0stdio

ocighcr.io/cloudcorprecords/vedicchart:0.1.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
date	string	否	要计算的公历日期，格式为 YYYY-MM-DD，例如 2026-07-25。年份范围为 1200–2400。省略则使用指定地点的今天日期（不是服务器日期）。
place	string	否	地点自由文本，格式为 "City, State, Country"，例如 "Jaipur, Rajasthan, India"。推奨输入：服务器端会将其地理编码为坐标和 IANA 时区，支持全球任意城市。仅当同时传入 latitude、longitude 和 timezone 时才省略。
latitude	number	否	十进制度数的纬度，范围为 -90 至 90，北纬为正（Delhi = 28.6139）。仅在省略 `place` 时使用，此时还必须提供经度和时区。
timezone	string	否	IANA 时区名称，例如 "Asia/Kolkata" 或 "America/New_York"（不能使用 "+05:30" 之类的偏移量）。使用 latitude/longitude 时必填；提供 `place` 时忽略。
longitude	number	否	十进制度数的经度，范围为 -180 至 180，东经为正（Delhi = 77.2090）。仅在省略 `place` 时使用。

详细介绍

vedicchart

连接托管 Vedic astrology 服务的本地 stdio 桥接器，不包含任何占星逻辑。

托管服务通过 Model Context Protocol 提供免费的 Vedic astrology 计算：每日 panchang、janam kundali 出生星盘、kundli 配对、dosha 检查（manglik、kaal sarp、sade sati）、dasha 时期、行星过境、muhurta 时辰、节日和日食日历，以及多种 Vedic 数字命理计算，总计 17 个工具。计算结果确定，使用 Swiss Ephemeris 和恒星黄道（Lahiri ayanamsa）计算。无需账号和 API 密钥；托管端点允许每个 IP 每分钟发送 30 个请求。

vedicchart 面向只支持 stdio 的 MCP 客户端。它在本地提供 tools/list——工具名称、描述和输入架构均来自托管服务，于 2026-10-27 实时获取并原样提供——并将每个 tools/call 转发到托管端点，原样返回结果。

配置

KUNDLIT_MCP_URL（可选）——托管 MCP 端点。默认为 https://kundlit.com/api/mcp。

调用流程

每次转发调用都会针对端点执行 streamable-HTTP JSON-RPC 序列：

发送 initialize 请求，
发送 notifications/initialized 通知，
发送 tools/call 请求本身。

如果服务器发出 Mcp-Session-Id 标头，则会在同一调用后续请求中将其发回。除普通 JSON 回复外，也支持以服务器发送事件格式封装的回复。

如果连接托管服务器失败——服务器不可访问、返回非 2xx 响应，或回复无法使用——调用会在本地失败，并返回 JSON-RPC -32001 错误，错误消息以 vedicchart error: 开头，而不会让客户端一直等待。托管服务器本身返回的错误也会在相同前缀下显示其原始消息。

工具

get_panchang — 指定日期和地点的每日 Hindu 历法：tithi、nakshatra、yoga、karana、vara、日出和日落时间，以及当天的吉时和凶时。
get_janam_kundali — 完整出生星盘：lagna、九大 graha、当前 dasha 和检测到的 yoga。
get_kundli_match — 两份出生星盘的 ashtakoot 配对。
check_manglik — 星盘是否带有 mangal dosha，以及其强度。
get_sade_sati — 出生星盘的 sade sati 状态和阶段。
check_kaal_sarp — 是否存在 kaal sarp dosha 及其类型。
get_pancha_pakshi — 出生星宿对应的 pancha pakshi 活动时段。
get_muhurta_timings — 用于择时的完整时段信息：choghadiya、horas 和应避开的时段。
get_year_events — 指定地点某一年的节日和纪念日。
get_eclipses — 某一年的日食和月食。
get_numerology — 根据姓名和出生日期计算的 Vedic 数字命理数字。
get_love_compatibility — 根据两位伴侣的信息计算配对情况。
get_mobile_numerology — 手机号码与其所有者之间的契合情况。
get_birth_details — 某个人的出生星宿和星盘基本信息。
get_dasha_periods — 出生星盘的 Vimshottari dasha 时期。
get_upapada_arudha — upapada 和 arudha lagna 计算。
get_transits — 某个星盘当前及即将发生的行星过境。

每个工具的权威描述——包括确切的输入、默认值和注意事项——以 tools/list 提供的内容为准，该内容是托管服务自身的文本。

CLI

每个工具都是一个子命令，接受一个 JSON 参数字符串；转发的结果以 JSON 格式打印：

npx @reneturcios/vedicchart get_panchang '{"place":"Jaipur, Rajasthan, India"}'
npx @reneturcios/vedicchart get_janam_kundali '{"birth_date":"1992-03-14","birth_time":"06:45","place":"Lucknow, India"}'
npx @reneturcios/vedicchart get_eclipses '{"year":2026}'
npx @reneturcios/vedicchart --version

退出代码：成功时为 0，运行时错误时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/vedicchart mcp

MCP 客户端配置：

{
  "mcpServers": {
    "vedicchart": {
      "command": "npx",
      "args": ["-y", "@reneturcios/vedicchart", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/vedicchart
docker run --rm ghcr.io/cloudcorprecords/vedicchart get_eclipses '{"year":2026}'

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source