FateTell

FateTell MCP

FateTell 负责计算；你的 AI 负责解读。

FateTell MCP 是一个托管的远程 MCP 服务（Streamable HTTP），可向任何 MCP 客户端返回确定性的八字（四柱）命盘、中国黄历数据，以及保存在 FateTell 账户中的命盘。该服务不会调用任何大模型：你已经在使用的 AI 会读取并解读结果。无需下载或运行任何内容。

此仓库保存该服务的公开元数据：适用于 Claude 和 Claude Code 的插件、适用于 Cursor 的插件、Hermes Agent 的 Agent Plugins 软件包、MCP Registry 条目，以及介绍如何解读 FateTell 结果的 fatetell-bazi 技能。服务本身不在此仓库中。

端点

端点	行为	适用对象
https://mcp.fatetell.com/mcp	默认端点。连接无需账户；排盘和黄历功能可匿名使用。需要账户的工具会通过 HTTP 401 质询作出响应，客户端随后会打开 FateTell 的登录页面。	Claude（网页版、桌面版、移动版）、Claude Code、Codex、VS Code 和大多数其他客户端
https://mcp.fatetell.com/login/mcp	连接时登录。第一个请求就会返回 401，因此登录会在客户端连接时进行。此端点上的所有工具都需要登录；不支持匿名使用。	仅在连接时启动登录的客户端：Cursor、Grok Bot、Manus 和 Hermes Agent 自带的服务条目
https://mcp.fatetell.com/chatgpt/mcp	ChatGPT 专用端点；工具相同，登录流程遵循 ChatGPT 的应用惯例。	仅限 ChatGPT

所有端点上的工具、输入和结果都相同。登录使用 OAuth 2.1；无需提前配置密钥或令牌。

安装

Claude（网页版、桌面版、移动版）

设置 → 连接器 → 添加 → 添加自定义连接器。名称填写 FateTell，URL：

https://mcp.fatetell.com/mcp

在身份验证下选择 需要时登录（Claude 默认会检测为“无需登录”，因为免费工具无需账户即可使用；如果选择该项，它就不会为账户功能提供登录选项）。保留 Claude 已发布的 OAuth 客户端身份，不要输入密钥。连接器会关联到你的 Claude 账户，因此桌面应用和移动应用也会自动显示。FateTell 插件在 Claude 目录中上线后，从目录安装即可添加同一个连接器和技能。

Claude Code

此仓库也提供 Claude Code 插件市场。该插件会添加连接器（/mcp）和 fatetell-bazi 技能：

claude plugin marketplace add RussGuo/fatetell-mcp
claude plugin install fatetell@fatetell

仅添加连接器，不安装技能：

claude mcp add --transport http fatetell https://mcp.fatetell.com/mcp

在名称前添加 --scope user，即可在所有项目中使用。若要提前登录，请运行 claude mcp login fatetell；否则，在首次使用账户功能时会提示登录。/mcp 可显示连接状态。

Codex

codex mcp add fatetell --url https://mcp.fatetell.com/mcp

Codex 会立即打开 FateTell 的登录页面。如果浏览器未打开，请运行 codex mcp login fatetell。在 ChatGPT 桌面应用中，Codex 有自己的页面：设置 → 插件 → MCP → 添加，使用相同的 URL。

ChatGPT

在 chatgpt.com（或桌面应用）中：插件 → 添加 → 添加自定义 MCP 服务。名称填写 FateTell，连接方式保持为“服务 URL”，并使用 ChatGPT 的端点：

https://mcp.fatetell.com/chatgpt/mcp

身份验证保持为 OAuth，不要更改高级 OAuth 设置，勾选确认框，然后选择 创建为插件。ChatGPT 会打开 FateTell 的登录页面；选择 允许。此端点仅在 ChatGPT 中使用。

Cursor

Cursor Marketplace 上线 FateTell 后，可直接安装；该插件会连接到登录端点。若要手动添加，请打开此链接并选择 安装：

添加到 Cursor

或将此条目添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "fatetell": { "url": "https://mcp.fatetell.com/login/mcp" }
  }
}

Cursor 会在连接时提示你登录 FateTell。Cursor 仅会在此阶段处理登录质询，因此此处使用 /login/mcp，而不是默认端点。

VS Code

code --add-mcp '{"name":"fatetell","url":"https://mcp.fatetell.com/mcp"}'

聊天首次使用需要你的账户的功能时，请按照提示登录。

Grok Bot

Grok Bot 是 Cursor 的云端 Agent。将 FateTell 添加为远程 MCP 连接器，并使用登录端点；或者让 Grok Bot 帮你添加：

https://mcp.fatetell.com/login/mcp

Manus

在 manus.im 上：Plugins → Create → Custom MCP。Server Name 填写 FateTell，Transport Type 选择 HTTP，Server URL 填写：

https://mcp.fatetell.com/login/mcp

将 headers 留空并选择 Save；Manus 会在连接时开始登录。

Hermes Agent

此仓库也是一个 Agent Plugins 软件包，Hermes Agent 会将其作为插件安装。该软件包会添加连接器（/mcp）和 fatetell-bazi 技能；Hermes 会以禁用状态安装它，因此之后需要启用：

hermes plugins install RussGuo/fatetell-mcp --no-enable
hermes plugins enable fatetell

FateTell 列入 Hermes 插件目录后，运行 hermes plugins install fatetell 即可安装相同的软件包。排盘和黄历功能可以立即使用。该软件包会将服务标记为不受信任，因此 Hermes 会在调用任何未标记为只读的工具前征求许可；create_saved_chart 是唯一此类工具。

插件软件包无法声明登录方式，因此账户功能需要你自行添加服务条目。在 Hermes 的 config.yaml 中，将以下内容添加到 mcp_servers 下，与已有服务并列：

mcp_servers:
  fatetell:
    url: https://mcp.fatetell.com/login/mcp
    auth: oauth
    trust: untrusted

然后登录：

hermes mcp login fatetell

此条目会替换软件包中同名的连接器，包括其信任设置，因此其中会重复设置 trust: untrusted。它使用登录端点，因为 Hermes 只会在连接时由服务发起请求后才登录；使用默认端点时，hermes mcp login 找不到可登录的服务。Hermes 会自行存储并刷新令牌。

其他 MCP 客户端

添加名为 fatetell 的远程 MCP 服务，使用 Streamable HTTP（通常称为 http）、默认端点、OAuth 身份验证，且不使用密钥或标头：

https://mcp.fatetell.com/mcp

如果客户端已连接，但使用账户功能时始终没有打开登录页面，那么它属于只会在连接时登录的客户端：请改用 https://mcp.fatetell.com/login/mcp。

能够运行命令或编辑自身 MCP 设置的 Agent，也可以通过 install.md 自行配置：

阅读 https://mcp.fatetell.com/install.md，并按照说明连接到 FateTell MCP。

工具

共有九个工具，结果均具有确定性。访问级别详见登录和权限。

工具	标题	访问级别	范围	功能
cast_bazi_chart	排出八字命盘	匿名	—	根据出生信息计算八字命盘：包括带十神的四柱、藏干、纳音、日主、所有大运、宫位和今日四柱；南半球出生者采用跨地区规则。
get_almanac	获取黄历	匿名	—	返回连续 1 至 31 天的中国黄历：公历和农历日期、节气，以及年柱、月柱和日柱。
get_fatetell_account	获取 FateTell 账户信息	已登录	account:read	返回已关联的 FateTell 账户信息：已屏蔽的电子邮件、登录方式、界面语言、时区、会员状态、授予此客户端的权限，以及此账户各工具的剩余配额。
list_saved_charts	列出已保存的命盘	已登录	chart:read	列出已关联 FateTell 账户中保存的命盘：ID、显示名称、性别、是否为用户本人的命盘、半球、命盘规则版本，以及命盘是否已计算。
get_saved_chart	获取已保存的命盘	已登录	chart:read	完整返回一张已保存的命盘：出生日期、时间和时区（不含出生地）、带十神的四柱、藏干和纳音、所有大运（标记当前大运）、宫位、已存储的日主强弱和喜用五行，以及今日四柱。
get_bazi_judgment	获取八字判断	会员	chart:read	根据出生信息或已保存的 chart_id，按照规则集 v1.0 返回 FateTell 的日主判断（身强、身弱、从强、从弱），以及按优先级排列的喜用、不利和中性五行。
get_daily_fortune	获取每日运势	会员	fortune:read	返回已保存命盘某一日期的每日运势：能量水平（高／中／低）、该日干支与本命命盘的关系、该日宜忌、日柱、此命盘的年柱和月柱，以及月冲。
get_chart_calendar	获取命盘日历	会员	fortune:read	返回已保存命盘的未来日期视图：逐日返回最多 31 天的年柱、月柱和日柱（按此命盘所在半球调整）、与本命四柱的关系、月冲和节气；或逐月返回最多 12 个月的月柱及其与本命四柱的关系。
create_saved_chart	创建已保存的命盘	会员	chart:write	根据姓名、性别、公历出生日期、可选的出生时间和出生地，在已关联的 FateTell 账户中保存新命盘；时区和半球根据出生地确定，与应用中的规则相同。

create_saved_chart 是唯一具有写入功能的工具；它会添加命盘，但不能编辑或删除现有命盘。其他所有工具均为只读。每个结果都包含其规则版本，相同输入始终会产生相同结果。

登录与权限

共有三个访问等级；每个等级都包含之前等级的所有权限。

等级	所需条件	工具
匿名	无（仅限默认端点）	cast_bazi_chart、get_almanac
已登录	FateTell 账户	get_fatetell_account、list_saved_charts、get_saved_chart
会员	有效的 FateTell 会员资格	get_bazi_judgment、get_daily_fortune、get_chart_calendar、create_saved_chart

• OAuth 2.1：使用带 PKCE（S256）的授权码流程。授权服务器为 https://auth.fatetell.com；你可在 FateTell 自有页面 https://web.fatetell.com 上登录并批准授权。你的 AI 永远不会看到你的密码。
• 客户端注册：同时支持客户端 ID 元数据文档和动态客户端注册，因此无需配置客户端 ID。
• 作用域：account:read（账户和会员状态）、chart:read（已保存的命盘和 FateTell 的判断）、fortune:read（每日运势和命盘日历）、chart:write（创建新命盘；在授权页面单独列出）、offline_access（保持连接，无需再次登录）。ChatGPT 还会请求 openid 和 email。
• 每次调用都会检查会员资格，不会在登录时固定。相同的会员资格可在 FateTell 应用、网站和此处使用；你在此处可执行的操作与在应用中相同。
• 断开连接：FateTell 网站 → 系统设置 → 已连接的应用 → 断开连接。AI 会在一分钟内失去访问权限。

测试连接器

任何评估或试用此连接器的人都可以使用，无论是否拥有 FateTell 账户：

1. 连接默认端点 https://mcp.fatetell.com/mcp，或让 Cursor、Grok Bot 或 Hermes 配置使用登录端点。可以使用任意电子邮件地址登录：系统会向该地址发送验证码，新账户免费。
2. 不登录（默认端点）时，询问：“排出我的八字命盘，女性，1990 年 7 月 1 日 10:00 出生于悉尼”以及“今天的日柱是什么？”应该会立即得到回答。
3. 使用免费账户登录后，询问“读取我保存的命盘”会列出并打开该账户中的命盘。新账户中没有命盘，因此请先在 FateTell 应用或网站中创建一个，或跳到下一步。
4. 会员工具（判断日主、每日运势、命盘日历、保存新命盘）需要有效的会员资格。目录和市场的审核人员可按需通过 [email protected] 获取含会员资格和已保存命盘的审核账户；该账户绝不会发布在此代码库中。
5. 保存命盘是唯一的写入操作：请求“保存一个新命盘”，工具就会添加一个；不会编辑或删除任何内容。断开 FateTell 网站上的连接（系统设置 → 已连接的应用）即可测试撤销访问权限。

使用限制

每个工具都有使用上限。这些上限仅用于防止滥用，不是可用额度，也不与 FateTell 应用中的任何使用次数关联；达到上限时，只会返回上限值及重置时间。

• 已登录：每个工具都有账户每日上限，另有合计每日上限。每日周期按 UTC 计算。
• 在默认端点上匿名使用：未识别匿名用户的客户端共用一个每小时重置的公共上限。达到上限后，登录即可改用你自己账户的计数。
• 在 24 小时内重复询问相同内容不会计入次数。查询 1 到 31 天的黄历只计一次。查看账户信息不计入次数。
• 已保存的命盘也受与应用相同的总数限制。

登录后，get_fatetell_account 会报告每个工具的上限、当前使用量和重置时间。

数据与隐私

• 服务器上没有大模型。 FateTell MCP 负责计算和读取数据，不会看到你与 AI 的对话。
• 匿名使用不会被存储。 cast_bazi_chart 和 get_almanac 的输入和结果不会写入任何数据库，也不会关联到任何人。为避免重复问题被重复计数，结果会按请求哈希值保存在服务器内存中，最长 24 小时，随后丢弃。
• 日志会记录运行了哪个工具、耗时、结果、任何错误代码以及输入的密钥哈希值。日志绝不会记录出生日期、出生时间、经度、地点名称或命盘名称。
• 登录后的读取只会返回你在同意页面批准的内容。返回的已保存命盘不会包含填写的出生地，也不会包含坐标。
• 保存命盘是唯一会用到地点名称的功能：FateTell 会用它查找时区和半球，与在应用中创建命盘时完全相同。FateTell MCP 本身不会保存或记录该名称。为他人保存命盘需要征得对方知情同意。
• 此代码库中的插件会发送什么：插件不包含任何代码。它们只连接到 mcp.fatetell.com；登录会通过 auth.fatetell.com 和 web.fatetell.com 进行。不会向其他任何地方发送数据。

AI 获得结果后，如何存储结果（例如存入聊天记录）由该应用自身的政策决定。

八字结果仅供参考，不能替代医疗、法律或财务建议。AI 如何解读 FateTell 的数据，属于 AI 自身的解读。

• 隐私政策：https://fatetell.com/privacyPolicy（第 8 节介绍通过 MCP 连接：https://fatetell.com/privacyPolicy#mcp）
• 服务条款：https://fatetell.com/terms（第 9 节为 MCP 服务条款：https://fatetell.com/terms#mcp）
• 文档：https://fatetell.com/mcp/docs · 常见问题：https://fatetell.com/mcp/faq

支持与安全

• 支持：[email protected]
• 安全问题报告：发送至 [email protected]，并在主题中注明“Security”。请私下报告漏洞，不要在公开议题中披露。

注册表

MCP 注册表名称：com.fatetell/mcp。条目为 server.json，仅列出默认端点 https://mcp.fatetell.com/mcp。

仓库内容

.claude-plugin/plugin.json        Claude plugin manifest (Claude, Cowork, Claude Code)
.claude-plugin/marketplace.json   single-plugin marketplace: this repository
.mcp.json                         Claude plugin connector: https://mcp.fatetell.com/mcp
.cursor-plugin/plugin.json        Cursor plugin manifest, connector inline: https://mcp.fatetell.com/login/mcp
plugin.json                       Agent Plugins package manifest (Hermes Agent)
mcp.json                          Agent Plugins connector: https://mcp.fatetell.com/mcp
skills/fatetell-bazi/SKILL.md     reading skill, shared by all three packages
server.json                       MCP Registry entry
assets/                           icons: SVG master and 1024 / 512 PNG on a paper-colored plate, a 512 white-plate variant for directory tiles, and a transparent 512 mark

使用 claude plugin validate --strict . 验证 Claude 插件，并使用 hermes plugins validate . --install-deps 验证 Hermes 软件包。

许可证

此代码库中的文件根据 MIT 许可证发布。许可证仅适用于此代码库；FateTell 服务及其计算引擎并非开源。