Vedika Astrology and Vastu

@vedika-io/mcp-server

Vedika Intelligence API 的 MCP 服务 — 提供吠陀、西方、KP、中国、塔罗、易经、人类图、数字命理和阿育吠陀领域的占星、占卜与风水能力，并以语义工具的形式开放给 AI Agent 使用。

该服务调用 Vedika API 中有文档说明的操作。各工具提供的计算和解读范围因工具和账户套餐而异。

发现元数据

server.json 描述文件将此软件包标识为 io.github.vedika-io/vedika-mcp-server，并使用标准输入／输出传输方式。它声明 VEDIKA_API_KEY 为必需的密钥环境变量。请在 MCP 客户端的私有环境设置中提供密钥；描述文件中不包含密钥值。

快速开始

npm install -g @vedika-io/mcp-server

可在 vedika.io/pricing 获取 API 密钥（每月 12 美元起）。没有免费套餐 — 每次查询都需要付费。

配置

密钥放在哪里，比使用哪个客户端更重要。

• 将密钥放在客户端的已加入 gitignore 的本地设置文件中，绝不要放在共享文件中。提交到配置文件中的密钥，就等于已经公开了密钥。
• 固定版本。 以下示例固定使用 @2.0.9。如果不指定版本，npx -y @vedika-io/mcp-server 每次启动时都会解析 npm 当前标记为 latest 的版本，因此一旦发布有问题或遭劫持的版本，它就会立即运行，而且没有任何记录能说明你之前使用的是哪个版本。
• 低于 2.0.4 的版本会将密钥发送到 VEDIKA_BASE_URL 指定的任意地址，并在跟随重定向时携带密钥。不要固定使用低于 2.0.4 的版本。
• 密钥是付款凭证：每次查询都需要付费。请像保护银行卡号一样保护它，而不要把它当作普通设置。

Claude Desktop

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

{
  "mcpServers": {
    "vedika": {
      "command": "npx",
      "args": ["-y", "@vedika-io/[email protected]"],
      "env": {
        "VEDIKA_API_KEY": "vk_live_your_key_here"
      }
    }
  }
}

Claude Code

添加到 .claude/settings.local.json：

不要添加到 .claude/settings.json。 该文件是共享且会纳入版本控制的文件 — 将密钥放在那里，就会提交、推送，并永久保留在历史记录中。本地文件 settings.local.json 已加入 gitignore，只会保存在你的设备上。本 README 在 2026-09-07 之前一直写的是 settings.json，而已发布的 2.0.3 软件包中仍然如此。

{
  "mcpServers": {
    "vedika": {
      "command": "npx",
      "args": ["-y", "@vedika-io/[email protected]"],
      "env": {
        "VEDIKA_API_KEY": "vk_live_your_key_here"
      }
    }
  }
}

Cursor

添加到 Cursor 设置 > MCP 服务：

{
  "vedika": {
    "command": "npx",
    "args": ["-y", "@vedika-io/[email protected]"],
    "env": {
      "VEDIKA_API_KEY": "vk_live_your_key_here"
    }
  }
}

Windsurf

添加到 ~/.windsurf/mcp_config.json：

{
  "mcpServers": {
    "vedika": {
      "command": "npx",
      "args": ["-y", "@vedika-io/[email protected]"],
      "env": {
        "VEDIKA_API_KEY": "vk_live_your_key_here"
      }
    }
  }
}

环境变量

变量	必需	默认值	描述
VEDIKA_API_KEY	是	—	你的 API 密钥（格式：vk_live_*）。以 Authorization: Bearer 形式发送。
VEDIKA_BASE_URL	否	https://api.vedika.io	仅接受 https://api.vedika.io 和免费沙盒 https://api.vedika.io/sandbox。任何其他值都会导致服务在启动时停止，从而确保密钥不会被路由到其他主机。

---

工具

核心

工具	描述	费用
vedika_ai_chat	支持选择吠陀、西方或 KP 体系的自然语言问答，以及后续对话。可用的操作和语言取决于路由和账户套餐。	当前计费条款
vedika_conversation	列出、获取、删除或延续多轮对话。	免费

吠陀计算

工具	类型	费用
vedika_birth_chart	kundli、出生星盘、行星位置、宫位宫头、上升点、出生信息	$0.016-0.028
vedika_dasha	vimshottari、mahādasha、antardasha、pratyantardasha、yogini	$0.016-0.028
vedika_doshas	mangal、kaal-sarp、pitru、nadi、全部、sade-sati、进阶 sade-sati	$0.016-0.040
vedika_compatibility	guna-milan、kundali、nakshatra-porutham、thirumana-porutham	$0.040-0.048
vedika_panchang	完整、tithi、nakshatra、yoga、karana	$0.012
vedika_muhurta	choghadiya、hora、rahu-kaal、gulika-kaal、yamaghanta、abhijit、brahma、durmuhurta、组合、吉利时刻	$0.012-0.020
vedika_divisional_charts	D2-D60（15 种星盘：Hora、Drekkana、Chaturthamsa、Saptamsa、Navamsa、Dashamsa、Dwadashamsa、Shodasamsa、Vimsamsa、Chaturvimsamsa、Bhamsa、Trimsamsa、Khavedamsa、Akshavedamsa、Shashtiamsa）	$0.005
vedika_predictions	每日、每周、每月、每季度、每年	$0.020-0.088
vedika_ashtakavarga	行星（Bhinnashtakavarga）、全部（Sarvashtakavarga）	$0.025

西方占星学

工具	类型	费用
vedika_western_transits	星盘、位置、相位	$0.064
vedika_western_progressions	星盘、位置、相位	$0.092
vedika_western_solar_return	星盘、位置、相位	$0.120
vedika_western_relationship	synastry、synastry 相位、组合盘、组合盘相位	$0.148

跨体系（3 个工具）

工具	类型	费用
vedika_horoscope	吠陀每日／每周／每月；西方每日或进阶每日	请确认当前 API 定价
vedika_numerology	生命路径、命运、人格、灵魂渴望、个人年、完整、兼容性	$0.003-0.010
vedika_varshaphal	吠陀年度太阳回归（Tajaka 体系）	$0.006

补充工具

工具	类型	费用
vedika_strength	chandra-bala、tara-bala、upagraha、行星关系、shadbala	$0.020
vedika_calendar	ritu、至点、anandadi-yoga、吉利 yoga、吉利时段、不吉时段、gowri-nalla-neram、disha-shool、行星过境、chandrashtama、chandrashtama 时段	$0.016-0.020

塔罗与占卜

工具	描述	费用
vedika_tarot_draw	使用单张牌、三张牌、凯尔特十字、马蹄形、关系或职业牌阵抽取塔罗牌。可选 Rider-Waite、Thoth 或 Marseille 牌组。	$0.020-0.048
vedika_tarot_daily	每日牌卡，附带释义、关键词和每日指引。每日缓存。	$0.008
vedika_iching_cast	起一卦《易经》（蓍草法或铜钱法）。提供本卦、变爻和之卦。	$0.012

中国占星术

工具	描述	费用
vedika_chinese_zodiac	生肖动物、五行、阴阳、幸运数字／颜色、相合／相冲的生肖。会考虑中国新年的日期。	$0.003
vedika_chinese_bazi	根据不含时区的日期时间生成基础八字命盘：年／月／日／时柱、日主、主导五行及五行平衡。对于带时区的输入，在民用时间、时区时间或太阳时语义尚未明确前会暂缓处理。	请确认当前 API 定价

其他体系

工具	描述	费用
vedika_human_design_chart	人类图 BodyGraph：类型、策略、权威、人生角色、定义／未定义的中心、通道、闸门。	$0.040
vedika_crystals_recommend	根据星座、行星或需求推荐水晶和宝石。结合吠陀 ratna-shastra 与现代水晶疗愈。	$0.012

吠陀扩展

工具	描述	费用
vedika_matrimony_match	Kundali 匹配：36 分 Ashtakoota、Dashakoot 摘要、dosha 取消情况及总体结论。Porutham 请设置 southIndian: true。	请确认当前 API 定价
vedika_dasha_ashtottari	Ashtottari 108 年大运周期（Vimshottari 的替代方案）。包含 8 颗行星及 Mahadasha/Antardasha/Pratyantardasha 深度分析。	$0.020
vedika_lalkitab_remedies	针对受克行星的 Lal Kitab 补救方法。包含区别于经典 BPHS 的独特 totka（实用补救方法）。可选债务（rina）分析。	$0.020
vedika_spiritual_mantra	根据经典文本提供个性化咒语建议。包含梵语 + IAST 转写、诵念次数、择时和念珠材质。	$0.016

灵性与健康

工具	描述	费用
vedika_spiritual_deity	根据 Navamsa 中的 Atmakaraka 推算 Ishta Devata（个人神祇）。也包括 Dharma、Palana 和 Guru Devata。依据 BPHS 第 33 章。	$0.020
vedika_health_ayurvedic	根据出生星盘分析阿育吠陀 Prakriti（体质）。包括 Vata/Pitta/Kapha 平衡、饮食、草药及季节性建议。	$0.024

套件

工具	描述	费用
vedika_daily_bundle	一次调用获取当天的通用内容：塔罗牌、天使数字、水晶、咒语、月相、符文和 I Ching。并非按星座划分的每日运势。	请确认当前 API 定价
vedika_numerology_complete	完整数字命理报告：生命路径、命运、灵魂渴望、人格、成熟度、顶点、挑战、业力债务/课题。可选毕达哥拉斯或迦勒底体系。	$0.010

实用工具

工具	描述	费用
vedika_usage	查看钱包余额、使用历史、摘要和模型细分	免费

Vastu

工具	描述
vastu_reference	静态 Vastu 参考表（曼陀罗网格、方位、缺陷、补救方法、颜色、材料、入口阻碍物）
vastu_audit_floor_plan	根据房间所处的罗盘方位区域审核房间列表
vastu_room_placement	提供某一方位区域内某种房间类型的布局指导
vastu_mandala_project	将 Vastu Purusha Mandala 网格投射到地块多边形上
vastu_generate_plan	根据地块和房间规划生成符合 Vastu 的平面图
vastu_declination	磁偏角粗略参考估算
vastu_operation	根据路径后缀调用其他任何 Vastu 操作。assessments/batch 需要保留 idempotencyKey
vastu_job_submit、vastu_job_status、vastu_job_results、vastu_job_cancel、vastu_job_artifact	批量 Vastu 作业和产物（见下文）

---

输入模式

出生信息（大多数吠陀/西方工具必需）

{
  "datetime": "1990-06-15T14:30:00",
  "latitude": 28.6139,
  "longitude": 77.2090,
  "timezone": "+05:30",
  "ayanamsa": "lahiri"
}

字段	类型	必填	备注
datetime	字符串	是	ISO 8601 格式。要准确计算宫位/上升点，必须提供时间。
latitude	数字	是	-90 至 90。极地纬度 >66.5 将被拒绝（宫位计算不可靠）。
longitude	数字	是	-180 至 180。
timezone	字符串	是	优先使用 UTC 偏移量（+05:30）。也接受 IANA 名称（Asia/Kolkata）。
ayanamsa	字符串	否	默认值：lahiri。可选值：lahiri、kp、raman、yukteshwar、fagan-bradley、true-chitra、true-revati、ss-citra。仅适用于吠陀工具；西方工具会忽略此项。

吠陀合盘（男/女）

{
  "type": "guna-milan",
  "male": { "datetime": "1992-03-15T10:30:00", "latitude": 28.61, "longitude": 77.20, "timezone": "+05:30" },
  "female": { "datetime": "1994-07-22T08:15:00", "latitude": 19.07, "longitude": 72.87, "timezone": "+05:30" }
}

西方关系分析（person1/person2——性别中立）

{
  "type": "synastry",
  "person1": { "datetime": "1990-01-15T14:30:00", "latitude": 40.71, "longitude": -74.00, "timezone": "-05:00" },
  "person2": { "datetime": "1992-08-22T09:45:00", "latitude": 34.05, "longitude": -118.24, "timezone": "-08:00" }
}

仅需位置（panchang、muhurta）

{
  "type": "choghadiya",
  "latitude": 28.6139,
  "longitude": 77.2090,
  "timezone": "+05:30"
}

所有位置字段均为可选项——默认使用德里（28.6139，77.2090，+05:30）。

十二星座（预测、星座运势）

支持英语和印地语（罗马字转写）：

英语	印地语
aries	mesha
taurus	vrishabha
gemini	mithuna
cancer	karka
leo	simha
virgo	kanya
libra	tula
scorpio	vrishchika
sagittarius	dhanu
capricorn	makara
aquarius	kumbha
pisces	meena

塔罗牌阵

{
  "spread": "celtic-cross",
  "question": "What should I focus on this month?",
  "deck": "rider-waite"
}

中国八字

{
  "datetime": "1990-06-15T14:30:00"
}

婚姻匹配（新娘/新郎）

{
  "bride": { "datetime": "1994-07-22T08:15:00", "latitude": 19.07, "longitude": 72.87, "timezone": "+05:30", "gender": "female" },
  "groom": { "datetime": "1992-03-15T10:30:00", "latitude": 28.61, "longitude": 77.20, "timezone": "+05:30", "gender": "male" }
}

---

输出示例

vedika_birth_chart（type: "kundli"）

{
  "ascendant": { "sign": "Virgo", "degree": 14.23, "nakshatra": "Hasta", "pada": 2 },
  "planets": [
    { "name": "Sun", "sign": "Taurus", "house": 9, "degree": 0.85, "nakshatra": "Krittika", "pada": 4, "retrograde": false, "dignity": "Neutral" },
    { "name": "Moon", "sign": "Cancer", "house": 11, "degree": 22.14, "nakshatra": "Ashlesha", "pada": 3, "retrograde": false, "dignity": "Own" },
    { "name": "Mars", "sign": "Pisces", "house": 7, "degree": 6.52, "nakshatra": "Uttara Bhadrapada", "pada": 2, "retrograde": false, "dignity": "Neutral" }
  ],
  "houses": [
    { "house": 1, "sign": "Virgo", "degree": 14.23, "lord": "Mercury" },
    { "house": 2, "sign": "Libra", "degree": 12.15, "lord": "Venus" }
  ]
}

vedika_dasha（system: "vimshottari"）

{
  "currentDasha": {
    "mahadasha": { "planet": "Jupiter", "start": "2020-03-15", "end": "2036-03-15" },
    "antardasha": { "planet": "Saturn", "start": "2024-09-01", "end": "2027-03-15" },
    "pratyantar": { "planet": "Mercury", "start": "2025-11-20", "end": "2026-04-30" }
  },
  "dashaTimeline": [
    { "planet": "Ketu", "start": "1990-06-15", "end": "1997-06-15", "years": 7 },
    { "planet": "Venus", "start": "1997-06-15", "end": "2017-06-15", "years": 20 },
    { "planet": "Sun", "start": "2017-06-15", "end": "2023-06-15", "years": 6 }
  ]
}

vedika_tarot_draw（spread: "three-card"）

{
  "spread": "three-card",
  "cards": [
    { "position": "past", "card": "The Tower", "number": 16, "suit": "major", "reversed": false, "meaning": "Sudden upheaval, revelation, awakening" },
    { "position": "present", "card": "Two of Cups", "number": 2, "suit": "cups", "reversed": false, "meaning": "Partnership, harmony, mutual attraction" },
    { "position": "future", "card": "The Star", "number": 17, "suit": "major", "reversed": false, "meaning": "Hope, renewal, inspiration, serenity" }
  ],
  "deck": "rider-waite"
}

vedika_chinese_bazi

{
  "system": "chinese",
  "chart": {
    "yearPillar": { "stem": { "name": "Geng", "chinese": "庚", "element": "Metal", "polarity": "Yang" }, "branch": { "name": "Wu", "chinese": "午", "animal": "Horse", "element": "Fire", "polarity": "Yang" }, "label": "Geng Wu" },
    "monthPillar": { "stem": { "name": "Ren", "chinese": "壬", "element": "Water", "polarity": "Yang" }, "branch": { "name": "Wu", "chinese": "午", "animal": "Horse", "element": "Fire", "polarity": "Yang" }, "label": "Ren Wu" },
    "dayPillar": { "stem": { "name": "Xin", "chinese": "辛", "element": "Metal", "polarity": "Yin" }, "branch": { "name": "Hai", "chinese": "亥", "animal": "Pig", "element": "Water", "polarity": "Yin" }, "label": "Xin Hai" },
    "hourPillar": { "stem": { "name": "Yi", "chinese": "乙", "element": "Wood", "polarity": "Yin" }, "branch": { "name": "Wei", "chinese": "未", "animal": "Goat", "element": "Earth", "polarity": "Yin" }, "label": "Yi Wei" },
    "dayMaster": { "name": "Xin", "chinese": "辛", "element": "Metal", "polarity": "Yin" },
    "dominantElement": "Water",
    "elementBalance": { "Wood": 1, "Fire": 2, "Earth": 1, "Metal": 2, "Water": 2 }
  }
}

vedika_compatibility（type: "guna-milan"）

{
  "totalScore": 26,
  "maxScore": 36,
  "recommendation": "Good match",
  "factors": [
    { "name": "Varna", "score": 1, "maxScore": 1, "description": "Spiritual compatibility" },
    { "name": "Vashya", "score": 2, "maxScore": 2, "description": "Mutual attraction" },
    { "name": "Tara", "score": 3, "maxScore": 3, "description": "Birth star compatibility" },
    { "name": "Yoni", "score": 3, "maxScore": 4, "description": "Physical compatibility" },
    { "name": "Graha Maitri", "score": 5, "maxScore": 5, "description": "Mental compatibility" },
    { "name": "Gana", "score": 5, "maxScore": 6, "description": "Temperament" },
    { "name": "Bhakoot", "score": 7, "maxScore": 7, "description": "Health & wealth" },
    { "name": "Nadi", "score": 0, "maxScore": 8, "description": "Genetic compatibility" }
  ],
  "mangalDosha": { "male": false, "female": true, "compatible": true }
}

vedika_panchang（element: "full"）

{
  "date": "2026-03-13",
  "vara": { "name": "Friday", "deity": "Shukra" },
  "tithi": { "name": "Krishna Chaturdashi", "deity": "Shiva", "endTime": "2026-03-13T18:45:00+05:30" },
  "nakshatra": { "name": "Purva Bhadrapada", "lord": "Jupiter", "endTime": "2026-03-13T22:10:00+05:30" },
  "yoga": { "name": "Siddha", "endTime": "2026-03-13T15:30:00+05:30" },
  "karana": { "name": "Vanija", "endTime": "2026-03-13T18:45:00+05:30" },
  "sunrise": "06:28:00+05:30",
  "sunset": "18:22:00+05:30"
}

vedika_ai_chat

{
  "response": "Based on your birth chart, Jupiter is currently transiting your 7th house...",
  "conversationId": "conv_abc123",
  "tokens": { "input": 1250, "output": 480 },
  "cost": 0.012,
  "system": "vedic"
}

vedika_predictions（period: "daily"）

{
  "sign": "aries",
  "period": "daily",
  "date": "2026-03-13",
  "prediction": {
    "overall": "A favorable day for career decisions...",
    "career": "Professional growth opportunities emerge...",
    "love": "Venus influence brings harmony...",
    "health": "Focus on physical activity...",
    "finance": "Avoid impulsive spending..."
  },
  "luckyNumber": 7,
  "luckyColor": "Red"
}

vedika_western_transits（type: "aspects"）

{
  "transitAspects": [
    {
      "transitPlanet": "Saturn",
      "transitSign": "Pisces",
      "transitDegree": 22.5,
      "natalPlanet": "Moon",
      "natalSign": "Gemini",
      "natalDegree": 24.1,
      "aspect": "Square",
      "orb": 1.6,
      "applying": true,
      "influence": "challenging"
    }
  ]
}

vedika_usage（action: "wallet"）

{
  "walletBalance": 5456,
  "currency": "USD",
  "displayBalance": "$54.56",
  "plan": "professional",
  "subscriptionEndDate": "2026-04-01T00:00:00Z"
}

注意： walletBalance 的单位是美分。显示为美元时请除以 100。

---

错误处理

所有错误都会作为 MCP 工具错误返回，并附带描述性消息：

状态	含义	消息示例
400	输入无效	Bad Request: datetime is required
401	API 密钥错误	Invalid API key. Get one at https://vedika.io/pricing -- format: vk_live_*
402	余额不足	Insufficient wallet balance (required $0.016, available $0.005, deficit $0.011). Add funds at https://vedika.io/dashboard. Do not retry until the wallet is topped up. 不会重试。
403	订阅未激活	Subscription inactive or endpoint not included in your plan.
429	请求频率受限	根据响应正文中的 code 分类。RATE_LIMIT_EXCEEDED：Rate limited. Retry after 5s. DAILY_LIMIT_EXCEEDED：Daily call limit reached. Do not retry until the limit resets... 不会自动重试。
422	幂等键被拒绝	IDEMPOTENCY_NOT_SUPPORTED：该端点不接受密钥，且未尝试扣费；请在不带 idempotencyKey 的情况下重新发送。
5xx	服务端错误	GET 请求以及携带调用方 idempotencyKey 的 POST 请求会在间隔 1s 后重试一次。其他 POST 请求不会重试，因此失败的计费调用不会导致重复扣费。
超时	响应过慢	Request timed out after 30s -- /v2/astrology/kundli

超时配置

请求类型	超时	重试
AI 聊天（vedika_ai_chat）	90s	不重试（超时时间已较长）
POST 计算端点	30s	仅在带有 idempotencyKey 时对 5xx 重试一次；否则不重试
GET 端点	15s	对 5xx 重试一次

---

定价

没有免费套餐。每次查询都会产生费用。提供使用模拟数据的免费沙盒：设置 VEDIKA_BASE_URL=https://api.vedika.io/sandbox。另请参阅 vedika.io/sandbox。

套餐	价格	每月钱包额度	速率限制
入门版	$12/mo	$12	60 req/min
专业版	$60/mo	$60	120 req/min
商业版	$120/mo	$120	300 req/min
企业版	$240/mo	$240	600 req/min

在 vedika.io/pricing 获取 API 密钥。

---

技术详情

• 运行时：Node.js 20+
• 传输方式：stdio（MCP 标准）
• 依赖项：@modelcontextprotocol/sdk、zod（没有其他运行时依赖）
• HTTP：原生 fetch（不使用 axios）
• 幂等性：除非某个工具显式接收 idempotencyKey（Vastu 批处理、作业和 vastu_operation），否则不会发送幂等性标头或请求 ID 标头。对于 /v2，API 会将调用方发送的 x-request-id 视为幂等性声明；对于未通过幂等性认证的端点，API 会以 422 拒绝该请求。
• 重试：GET 请求以及携带 idempotencyKey 的 POST 请求遇到 5xx 时，会在间隔 1s 后重试一次。不带密钥的计费 POST 请求绝不重试。4xx 响应（包括 402 和 429）绝不重试。
• 超时：AI 聊天 90s，POST 计算 30s，GET 端点 15s
• 模块格式：此软件包仅支持 ESM（"type": "module"）。通过 npx/vedika-mcp-server 二进制文件（上述常规 MCP 客户端配置） 运行时，不受你自己的项目模块格式影响。如果你改为从 CommonJS 项目中将其作为库导入， 直接使用 require('@vedika-io/mcp-server') 将会抛出错误——请改用动态导入：

  const { VedikaApiClient } = await import('@vedika-io/mcp-server');
  

链接

• API 文档
• API 参考
• 定价
• 控制面板
• MCP 服务页面
• 支持

许可证

MIT

Vastu 作业和产物

调用 vastu_job_submit，将 request.operation 设置为 assessments、plan-analyze 或 plan-report，令 request.items 包含唯一的 {id, input} 对象，并保留调用方提供的 idempotencyKey。如需交付报告，请使用 input.format: "html"；JSON 报告和规划分析会提供 JSON 产物。提交后会返回稳定的 jobId 和 maxCharge 报价。每个成功处理的项目按现有的单项价格计费，不收取额外的作业费用；无效项目不计费。

使用 vastu_job_status 轮询数量和费用，使用 vastu_job_results 读取分页结果（nextCursor: null 表示分页结束），并使用带有 jobId 和 itemId 的 vastu_job_artifact 获取确切的交付物和收据。同一产物也可作为只读资源通过 vedika://vastu/jobs/{jobId}/items/{itemId} 访问；请对项目 ID 进行 URL 编码。结果和产物会在七天后过期。vastu_job_cancel 会停止尚未开始的项目；正在处理的项目仍可能完成并产生费用。使用 2.0.7 或更高版本的软件包来使用这些工具，并确认你的账户已开通作业功能。无需密钥的沙盒会返回无状态预览，无法保留作业以供查询状态或获取产物。