Kundlit Vedic Astrology

Kundlit 吠陀占星术 — MCP 服务

通过 Model Context Protocol 为 AI 助手提供免费的吠陀占星计算：任意城市的每日 panchang 和 muhurta 时间、janam kundali 出生星盘、kundli milan（ashtakoot）匹配、dosha 检查、dasha 时期、行星过境、节日和日食日历，以及吠陀数字命理——共 17 个工具（动态发现），另有提示词和文档资源。

计算结果具有确定性——基于恒星黄道（Lahiri ayanamsa），使用 Swiss Ephemeris 实时计算——并附有来自古典文本的引文，详见 kundlit.com。

• 服务 URL： https://kundlit.com/api/mcp（托管，Streamable HTTP）
• 身份验证： 无需账户或 API 密钥
• 速率限制： 每个 IP 每分钟 30 次请求
• 文档： https://kundlit.com/mcp
• 隐私： https://kundlit.com/privacy · 支持： [email protected]

安装

1. npx（适用于所有客户端，包括仅支持 stdio 的客户端）

npx -y @kundlit/mcp

这会启动一个本地 stdio MCP 服务，并将请求代理到托管端点。通过指定命令，即可将任意客户端指向该服务：

Claude Desktop — claude_desktop_config.json：

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

Cursor — .cursor/mcp.json，或任何读取通用 .mcp.json 的客户端：

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

全局安装（npm i -g @kundlit/mcp）后，二进制文件名为 kundlit-mcp，因此只需使用 "command": "kundlit-mcp"，无需参数。

2. 直接使用 Streamable HTTP（支持远程服务的客户端）

无需桥接进程——直接连接到该 URL。

Claude Code：

claude mcp add --transport http kundlit https://kundlit.com/api/mcp

配置文件：

{
  "mcpServers": {
    "kundlit-astro": {
      "type": "http",
      "url": "https://kundlit.com/api/mcp"
    }
  }
}

Claude（网页版/桌面版）： Settings → Connectors → Add custom connector → https://kundlit.com/api/mcp

各客户端的完整说明、示例提示词和限制： https://kundlit.com/mcp

此代码库包含的内容

此处发布的 npm 包 @kundlit/mcp 是一个轻量客户端：在本地 StdioServerTransport 与指向 https://kundlit.com/api/mcp 的 StreamableHTTPClientTransport 之间双向转发 JSON-RPC。它不包含任何占星逻辑，也不包含工具列表的副本，因此托管服务上新增或更名的工具无需更新软件包即可使用。

两方向的帧都会原样转发，只有一种有意设置的例外：如果连接托管服务失败，桥接程序会在本地使用 JSON-RPC -32001 错误（bin/cli.js）回复待处理的请求，而不会让本地客户端一直等待永远不会收到的回复。该错误由桥接程序生成，并非服务端发送。

占星服务本身托管在 kundlit.com，其源代码不公开。此处的清单文件（.mcp.json、server.json、.claude-plugin/plugin.json）用于让 MCP 客户端、注册表和目录发现并安装该服务。

桥接选项

kundlit-mcp [--url <endpoint>]

  --url <endpoint>   Hosted MCP endpoint (default https://kundlit.com/api/mcp).
                     Also settable via KUNDLIT_MCP_URL; --url wins.
  -h, --help         Usage and a config snippet.
  -v, --version      Package version.

stdout 仅传输 JSON-RPC，不包含其他内容；包括 --help 和 --version 输出在内的所有诊断信息都发送到 stderr。需要 Node.js 18 或更高版本。

Docker

docker build -t kundlit-mcp .
docker run -i --rm kundlit-mcp

容器通过 stdio 使用 MCP，因此运行时请使用 -i，且不要分配 TTY。

开发

npm install
node scripts/smoke.mjs   # end-to-end check against the live hosted server

功能

共 17 个工具，通过 tools/list 动态发现——panchang、muhurta 和 choghadiya 时段、janam kundali、ashtakoot 匹配、manglik / kaal sarp / sade sati 检查、dasha 时期、行星过境、pancha pakshi、年度事件、日食和数字命理。提示词和文档资源（kundlit://docs/methodology、kundlit://docs/usage-guide）同样会在运行时发现；请让客户端列出这些内容，而不要依赖本 README 中的列表。

示例提示词

• “斋浦尔今天的 panchang 是什么？rahul kaal 是什么时候？”
• “为 1992 年 3 月 14 日上午 6:45 在勒克瑙出生的人排一张 janam kundali——我目前处于哪个 mahadasha？”
• “帮我找一个明天在浦那签租约的好时段——避开 rahu kaal 和 bhadra。”
• “瓦拉纳西 2026 年所有的 ekadashi 日期。”

说明

• 优先使用自由文本 place（全球任意城市）；也接受纬度/经度/IANA 时区。年份工具会将地点匹配到 50 个受支持城市中最近的城市。
• 结果仅供参考，不能替代专业建议。
• 每项结果都包含一行 Source: 署名信息 — 请保留完整；该署名是免费使用的代价。

许可证

MIT — 请参阅 LICENSE。