以前用渡星河，你要打开网页、填表、等报告、再自己读那三四万字。
现在多了一条路：在你常用的 AI 助手里直接说一句话，渡星河就把报告生成好，AI 还能帮你读、帮你找、帮你核对。 这一切靠的是一个叫 MCP 的东西。这篇就把它讲清楚。
一、先说人话：MCP 是什么
MCP（Model Context Protocol，模型上下文协议）你可以理解成 AI 助手的"万能接口"。
就像 USB 让你把各种设备插到电脑上一样，MCP 让 AI 助手（比如 Claude）能安全地调用外部服务。我们把渡星河做成了一个 MCP 服务，于是支持 MCP 的 AI 助手就能直接"用"渡星河——不用你来回切换网页和对话框，整件事在一个对话里就办完了。
一句话：MCP 让你在 AI 助手里，用大白话指挥渡星河排盘出报告。
二、渡星河 MCP 能做的事
接上之后，你的 AI 助手就解锁了这些能力：
- 生成全部 6 种报告：紫微斗数（本命 / 大限 / 流年 / 飞星）、八字四柱（本命 / 大运）。想要哪种，说一句就行。
- 帮你读懂报告：报告动辄三四万字，你不用自己翻。AI 能按章节列目录、定位到你关心的那一节、在全文里搜关键词，然后挑重点讲给你听。
- 基于真实排盘追问核验：你问"我命宫主星是什么""2026 流年的干支是啥"，AI 不是凭印象瞎编——它会去拿渡星河后端确定性排盘的数据（星曜、宫位、四化、大限流年干支），再回答你。
- 用的是你自己的账号：连接时你用自己的渡星河账号授权。生成的报告消耗你自己的通宝、进你自己的报告记录，和在网页上做出来的报告完全一样，能在网页端随时回看。
重点：排盘和报告都由渡星河服务端生成，AI 只负责"调用 + 转述"，不自己排盘、不自己编报告。所以你拿到的，还是那份专业的渡星河报告。
三、开始之前，准备两样东西
- 一个渡星河账号，且有通宝余额。 生成报告会消耗通宝，和网页端一样。没有余额会提示"额度不足"。
- 一个支持 MCP 的 AI 客户端。 比如 Claude Desktop、Claude Code、Cline、Cherry Studio 等都支持。下面以最常见的 Claude 系列为例。
四、怎么连接
渡星河 MCP 的服务地址是：
https://agent.stariver.me/mcp/
最简单的方法：直接让 AI 助手帮你装
现在很多 AI 助手已经能直接识别 MCP 安装指令。你可以先把下面这句话原样发给它：
帮我安装这个MCP： https://agent.stariver.me/mcp
它如果支持自动安装，就会自己走完后面的配置流程。说白了，这就是最省事的入口：你不用研究配置文件，也不用记命令。
如果你的客户端还不支持这种安装方式，再根据你用的客户端手动配置：
方法 A：Claude Code（命令行）
一行命令搞定：
claude mcp add --transport sse stariver https://agent.stariver.me/mcp/
方法 B：Claude Desktop 及其他支持配置文件的客户端
在客户端的 MCP 配置（如 claude_desktop_config.json）里加上这一段：
{
"mcpServers": {
"stariver": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://agent.stariver.me/mcp/"]
}
}
}
保存后重启客户端即可。（mcp-remote 是一个开源小桥接，会自动处理登录授权，需要本机装有 Node.js。）
首次连接：用你的账号登录授权
不论哪种方法，第一次连接时浏览器会自动弹出渡星河登录页。用你自己的账号登录、点"授权"，就完成了。之后这个 AI 助手生成的所有报告，都算在你的账号名下。
整个过程走的是标准 OAuth 授权——AI 客户端拿到的只是一个有时效的访问凭证，碰不到你的密码。
安装成功后，先测试一下
装好之后，你可以直接问 AI 助手：
stariver mcp现在有哪些工具可用
如果它能列出 generate_ziwei_report、generate_bazi_report、start_stariver_report 这些工具，就说明渡星河 MCP 已经接上了。
五、怎么用：直接对话就行
连好之后，像平时聊天一样下指令。几个例子：
生成本命报告
帮我用渡星河生成一份紫微斗数本命报告：1990 年 5 月 15 日早上 6 点半出生，北京，男。
AI 会创建任务、等它跑完（通常 1–3 分钟），然后告诉你报告好了。
读懂报告 / 追问
这份报告里，我的事业宫是怎么说的？
帮我找一下报告里关于"婚姻"的部分。
AI 会去报告里定位、搜索相关章节，挑重点讲给你听，而不是把三四万字一股脑甩给你。
换报告类型
再帮我看看 2026 年的流年运势。
我的大运是怎么走的？
（大限、大运这类报告，AI 会先列出可选的区间让你挑，再生成对应报告。）
核验命盘事实
我命宫的主星是什么？四化飞到哪几个宫？
AI 会调取渡星河的排盘数据来回答，确保星曜、宫位、四化这些事实是准的。
六、几个你可能会问的问题
会花钱（通宝）吗？ 会，和网页端一样按报告消耗你自己的通宝。读取、搜索已生成的报告不额外收费。
报告要等多久？ 完整报告通常 1–3 分钟。期间 AI 会帮你轮询进度，跑完自动通知你。
安全吗？ 你用自己的账号 OAuth 授权，AI 客户端拿到的是有时效的凭证，接触不到密码；报告也只进你自己的记录。
AI 会不会算错、瞎编？ 排盘和报告全部由渡星河服务端生成，AI 不参与排盘。它的角色是"帮你下单 + 帮你读报告"，所以专业度和你在网页上得到的一致。
写在最后
MCP 没有改变渡星河的内核——报告还是那份专业的报告。它改变的是你怎么用它：从"打开网页、填表、读长文"，变成"在 AI 助手里说一句话，剩下的交给它"。
如果你本来就常用 Claude 这类 AI 助手，花两分钟接上渡星河 MCP，下次想算一卦、看个运，直接开口就行。