把 Balance Engine 接进 AI · MCP 接入指南

这是什么

• 免费：今日节奏 · 流月预演（本地计算，零网络）
• 付费：个人日读（日主 × 当日天干 · 需账户密钥）
• 输出自带回站：流月笔记 · 订阅日历 · 免费月历

Balance Engine 作为 AI agent 的确定性工具层：agent 负责对话与安排，引擎负责可复算的时间节律。同一天问一百次，日柱与天象锚点不会变。

通过 MCP（Model Context Protocol）接入 Claude Desktop、Cursor 或任何兼容客户端。预演 ≠ 预测——只给作用关系与动作建议，不断言吉凶。

三步接入

• 装包 — 客户端用 npx -y balance-engine-mcp（见下方配置模板）
• 生成密钥 — 开通账户后打开 join.html「Agent API 密钥」，点生成，马上复制（只显示一次）
• 贴进配置并重载 — 密钥放进 BALANCE_API_KEY，重载窗口，开新对话试问「今天节奏怎么样？」

只试用免费工具时，密钥可以留空。个人日读（问「我今天」）才需要密钥。

配置模板（复制即可）

Claude Desktop / Cursor 的 MCP 配置：

{
  "mcpServers": {
    "balance-engine": {
      "command": "npx",
      "args": ["-y", "balance-engine-mcp"],
      "env": {
        "BALANCE_API_KEY": "be_你的密钥"
      }
    }
  }
}

Cursor 项目也可写在仓库 .cursor/mcp.json。配置后把 MCP 开关打开，等变绿，再开新对话。

工具一览

• today_rhythm — 今日节奏（免费）
• month_brief — 流月预演月报（免费）
• personal_day — 个人日读（需密钥；缺省读你网站上的出生档案）

试「agent 味」可以问：结合今天节奏安排下午工作；这个月哪几天适合发布。看 agent 是否把引擎输出当事实底座来推理。

收费怎么算

MCP 包本身免费。付费工具记账到既有订阅（个人 ¥365 / 公司 ¥3,650）——密钥只是账户的 agent 通道，不另收费。

更完整的产品说明见 使用说明；日历订阅见 calendar.html。