Astroway Mcp

Name: Astroway Mcp
Author: astroway

本地服务

github.com/astroway游戏娱乐43 周前更新

代码仓库

关于 Astroway Mcp

Astroway Mcp 将 AstroWay Calculation API 的占星、塔罗、数字命理和 Human Design 端点提供给 AI Agent 使用。工具目录由 API 清单在构建时生成，并可按类别筛选或使用精简发现模式。

主要功能

01提供本命盘、合盘和行运计算
02支持吠陀占星及多种 Dasha
03提供塔罗、数字命理和 Human Design
04按工具类别筛选注册内容
05精简模式按需发现和调用工具

适用场景

01计算本命盘及行星行运
02比较两人的占星盘
03生成塔罗牌阵解读
04按需查找特定占星 API 工具

MCP 相关

该 MCP 服务将 AstroWay Calculation API 端点注册为工具，供兼容客户端调用。客户端可选择完整工具目录、类别子集或精简发现模式。

#astrology #mcp #vedic #tarot #numerology #human-design #swiss-ephemeris #natal-chart #synastry #ai

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": [
        "-y",
        "@astroway/mcp"
      ],
      "env": {
        "ASTROWAY_API_KEY": "<ASTROWAY_API_KEY>"
      }
    }
  }
}

启动命令npx -y @astroway/mcp

需要配置的环境变量

ASTROWAY_API_KEY密钥

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

安装包

npm@astroway/mcpstdio

工具

735

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

此工具无需参数。

详细介绍

@astroway/mcp

MCP（Model Context Protocol）服务，将 AstroWay Calculation API 的每个端点作为工具提供给 Claude Desktop、Cursor 及任何兼容 MCP 的 AI Agent。

本命星盘、合盘、行运、吠陀占星大运（Vimshottari、Yogini、Ashtottari、Kalachakra）、16 种分盘、塔罗（Rider-Waite / Marseille / Lenormand）、数字命理（5 种体系）、人类图、AI 星座运势，全部封装为 MCP 工具，供 Agent 直接调用。

工具会在构建时根据实时 API 清单自动生成，因此每次发布都包含生产环境中存在的所有端点。无需手动维护工具列表。

安装

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": {
        "ASTROWAY_API_KEY": "aw_live_..."
      }
    }
  }
}

重启 Claude Desktop。astroway 服务会显示在聊天输入框底部的 MCP 指示器中。

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

Cline / Continue / Windsurf / Copilot / VS Code MCP

同一条 npx @astroway/mcp 命令适用于所有兼容 MCP 的客户端。将此代码块添加到客户端的 MCP 配置文件中（路径因客户端而异）：

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

配置位置：

客户端	配置路径
Cline（VS Code）	工作区根目录下的 `.cline/mcp.json`
Continue	`~/.continue/config.json`（位于 `mcpServers` 下）
Windsurf	`~/.codeium/windsurf/mcp_config.json`
GitHub Copilot Chat（VS Code）	在设置中启用预览，然后使用工作区中的 `mcp.json`
VS Code MCP 扩展	`~/.vscode/mcp.json`

其他 MCP 客户端

作为 stdio 服务运行：

ASTROWAY_API_KEY=aw_live_... npx @astroway/mcp

隐私

此 MCP 服务不会向外发送任何信息。没有遥测、分析、使用情况报告，也无需维护选择加入 / 退出开关。服务发起的唯一网络流量，是你要求它执行的 AstroWay API 调用，这些调用会从你的机器直接发送到 https://api.astroway.info/v1。

传出的请求会携带两个标识请求头，以便 AstroWay 后端在自己的日志中区分 MCP 流量和原始 HTTP 流量：

User-Agent: astroway-mcp/<version> (Node/<node-version>)
X-Astroway-Channel: mcp

这两个请求头都不包含会话 ID、机器指纹或任何个人信息。它们遵循标准 HTTP User-Agent 语义：每个命令行工具都会发送类似信息。

子集注册（高级）

如果你只使用目录中的部分内容，可以注册一个子集，让大模型上下文窗口保持精简：

{
  "env": {
    "ASTROWAY_API_KEY": "aw_live_...",
    "ASTROWAY_TOOL_GROUPS": "western,vedic,relational",   // only these prefixes
    "ASTROWAY_READONLY": "1"                               // skip ai/horoscope/reports (LLM-backed, costs credits)
  }
}

常见分组：western、vedic、tarot、numerology、hd（人类图）、relational（合盘 / 组合盘 / Davison 关系盘）、prognostics（行运 / 推运 / 回归盘）、aspects、horary、geo、chinese、bazi、mayan、iching、runes、geomancy。运行 npx @astroway/mcp --list-tools 可查看完整列表；启动行中的 filters: … 字段会显示已应用的筛选条件。

ASTROWAY_READONLY=1 会跳过内部调用大模型的三个分组（ai、horoscope、reports），适用于希望只进行确定性星盘计算、不消耗额度生成文本的情况。

精简发现模式

如果 Agent 因完整目录达到上下文或工具数量限制，请设置 ASTROWAY_DISCOVERY_MODE=1。服务不会预先注册 600 多个工具，而只会公开两个元工具：

astroway_find_tool(query, limit?)：对整个目录进行关键词搜索；返回最匹配的工具及其单行描述和输入参数名称。
astroway_call_tool(name, arguments?)：调用搜索结果中的任意工具。

Agent 按需发现合适的工具，然后调用它，仅占用两个工具的空间即可访问整个目录。

权衡：通过 astroway_call_tool 调度的工具只会以文本形式返回结果。运行时调度的调用无法声明每次调用的 outputSchema，因此无法携带直接注册的工具所提供的、经过验证的 structuredContent。如果需要带类型的结构化输出，请保持 ASTROWAY_DISCOVERY_MODE 未设置（默认值）；如果更在意工具数量限制，则使用此模式。发现模式会取代 ASTROWAY_TOOL_GROUPS / ASTROWAY_READONLY。

稳定性

目录在会话期间保持冻结。 整个目录（工具、提示词和资源）都打包在已发布的 npm 包中，不会在运行时更改。（SDK 会声明 MCP listChanged 能力，但此构建绝不会发出 */list_changed 通知。如果客户端在首次 tools/list 后缓存目录，整个连接期间缓存都将保持正确。）
工具标识符在主版本内保持稳定。 以 astroway_<group>_<tool> 名称发布的工具，在同一个 v0.x 次版本内不会重命名或移除，除非 CHANGELOG.md 中注明弃用。跨主版本升级（v1 → v2）时，任何破坏性更改都会提前公告，并可通过旧版兼容选项 MCP_FLAT_TOOLS=1 过渡一个次版本。
工具输入结构在次版本内保持稳定。 收紧限制（正则表达式、范围、枚举）会在补丁版本中发布；添加必填字段则需要提升次版本号。
重新安装以更新目录。 npm i -g @astroway/mcp@latest（或客户端配置中已有的 npx -y @astroway/mcp 形式）会在下次启动时获取当前版本。

验证安装

重启 MCP 客户端后：

打开 MCP 指示器（Claude Desktop 聊天输入框底部，或 Cursor 状态栏）。
你应该会看到 astroway 列为活动服务。
悬停或点击后，徽标会显示已注册的工具、提示词和资源数量；npx @astroway/mcp --list-tools 会打印已安装版本的完整工具列表。
首次冷启动需要 2-3 秒（Node + TLS 握手至 api.astroway.info）。
在任意终端进行基本检查：npx @astroway/mcp --version 会打印包版本，npx @astroway/mcp --list-tools synastry 会打印匹配的工具。

如果服务没有出现，请在上方的 env 块中设置 LOG_LEVEL=debug 并重启：启动日志和任何启动错误都会显示在客户端的 MCP 调试面板中。

获取 API 密钥

在 https://api.astroway.info/dashboard/sign-up 注册：每月免费 10 000 credits，无需银行卡。每次请求费用为 5–500 credits，具体取决于端点（参见定价）。

如需在本地测试且不订阅付费方案，请使用沙盒密钥（aw_test_...），它会免费返回确定性响应。

你将获得什么

以下是工具类别及示例。运行一次 npx @astroway/mcp，然后向 Agent 询问 "list astroway tools"，即可查看完整的实时工具清单（该软件包会在每次发布时自动与 API 同步）。

类别	示例
核心	本命盘、行星位置、龙首龙尾盘、谐波盘
比较	合盘、组合盘、戴维森盘、跨体系兼容性
预测	行运、次限推运、太阳回归／月亮回归、行运日历
专门星盘	日心盘、恒星黄道盘、日食搜索
相位与点位	相位表、反映点、中点、阿拉伯点、恒星
日历与周期	逆行周期、入宫、月相、行星时
尊贵与接纳	本质尊贵、阿尔穆滕、希莱格、定位星
卜卦占星	卜卦星盘、月亮空亡、焚毁之路
人类图	完整图表、行运、Penta、Dream Rave、全息基因档案
占星地理学	占星地图、本地空间、迁居星盘
吠陀占星	16 种分盘、Panchang、Shadbala、4 种大运系统 × 5 个级别（Vimshottari / Yogini / Ashtottari / Kalachakra）、瑜伽、Dosha、兼容性、择时
塔罗	Rider-Waite-Smith、Marseille、Lenormand 牌组；牌阵 + 单张牌查询
数字命理	毕达哥拉斯、迦勒底、卡巴拉、吠陀、命运矩阵
秘传学	易经、萨比恩符号、占卜骰子、颜色与宝石对应关系
参考资料	星座、行星、宫位、相位、纳克沙特拉、希腊化占星点位、本命盘文本（经编辑的解读内容，不含 AI）
AI 解读	本命盘、合盘、行运；由星盘数据支持的四种角色聊天；支持 21 种语言
星座运势	每日、每周、每月、兼容性（基于黄道星座）

示例提示词

连接服务后，可以在 Claude Desktop 中尝试以下提示词：

本命盘

为我计算本命盘。我出生于 1990-03-15 14:30，地点是乌克兰基辅（50.45N 30.52E，UTC+2）。请指出我的太阳、月亮、上升星座，以及所有紧密相位。

合盘

比较两张星盘：A 出生于 1988-06-10 09:15，地点是伦敦（51.51N -0.13E UTC+1）；B 出生于 1991-11-22 22:40，地点是柏林（52.52N 13.40E UTC+1）。最强的跨盘相位有哪些？

吠陀占星 Vimshottari 大运

为一位出生于 1985-07-22 06:45、地点是孟买（19.07N 72.87E UTC+5.5）的人运行 Vimshottari 大运。现在（2026 年 5 月）正处于哪颗行星的大运期？

行运预测

2027-01-01 有哪些重要的外行星行运影响我的本命盘？出生信息：1990-03-15 14:30，基辅（50.45 30.52 UTC+2）。

塔罗占卜

针对“我该接受这份新工作吗？”这个问题，从 Rider-Waite 牌组抽取一组过去—现在—未来三张牌阵。使用种子 42，以便结果可复现。

人类图

1990-03-15 14:30 出生于基辅（50.45 30.52 UTC+2）的人，其人类图类型、策略和权威是什么？请列出其定义中心和轮回交叉。

基于星盘的聊天

使用 astroway_mcp_ai_chat，询问我的土星落点意味着什么。出生信息：1990-03-15 14:30，基辅（50.45 30.52 UTC+2）。回答应引用所依据的宫位和相位容许度。

配置

环境变量	默认值	描述
`ASTROWAY_API_KEY`	(必填)	你的 API 密钥。正式环境：`aw_live_...`。沙盒环境：`aw_test_...`。
`ASTROWAY_BASE_URL`	`https://api.astroway.info/v1`	用于覆盖可自托管／暂存实例的地址。

工具的生成方式

构建时脚本会从生产 API 读取规范端点清单，按输入形状（chart、twoChart、chartTarget、horoscopeSign、year、date、generic）对每个端点进行分类，并生成类型化工具定义。随后，MCP 服务会使用相应的 Zod 输入架构，将每个条目注册为 MCP Tool。

API 发布新端点时，下一版 MCP 会自动提供这些端点，无需手动编写工具定义来保持同步。

故障排除

Claude Desktop 未显示该服务。 查看聊天输入框底部的 MCP 指示器（滑块图标）。点击它即可查看已注册的服务和任何启动错误。如果缺少 astroway，请在终端中手动运行 npx @astroway/mcp 命令，启动错误会输出到 stderr。

工具返回 Error 401。 API 密钥缺失、无效或已撤销。请前往 https://api.astroway.info/dashboard/keys 生成新密钥。

工具返回 Error 402。 免费套餐的额度已用完。请前往 https://api.astroway.info/pricing/ 升级，或等待每月重置。

工具返回 Error 422，并显示字段验证错误。 大模型传入的请求体未被 API 接受。请让 Claude 使用工具描述中显示的示例请求体重试，或使用沙盒密钥（aw_test_...）进行调试，避免消耗额度。

仓库结构

此仓库是 @astroway/mcp 的公开展示页：包含 README、CHANGELOG、LICENSE 和安装说明。可运行的代码就是已发布的 npm 包：使用 npm install @astroway/mcp 安装，或通过 npx @astroway/mcp 运行。

源代码在私有的 AstroWay 单体仓库中维护，以便构建时生成器读取相邻 API 工作区中的规范端点清单。生成的包采用 MIT 开源协议，并随每次发布推送到 npm。

更新日志

请参阅 CHANGELOG.md。

链接

📦 npm：https://www.npmjs.com/package/@astroway/mcp
📘 API 文档：https://api.astroway.info/docs/api/
🔑 注册与控制面板：https://api.astroway.info/dashboard/
💰 定价：https://api.astroway.info/pricing/
🌐 网站：https://astroway.info

许可证

MIT，详见 LICENSE。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。