askTIAN MCP Server 是一个面向 AI 智能体的中国玄学决策支持工具服务器，通过 Model Context Protocol（MCP）将八字、奇门、五行、每日干支能量等中国传统玄学体系封装为 AI 可调用的工具。其定位是为已具备搜索、记忆、支付等能力的 AI 智能体提供“立场层”——给出具体、可证伪的判断，而非“视情况而定”的模糊回答。
【用途】 当用户向 AI 助手提出关于时机、人物或决策的问题时，AI 可以悄然调用 askTIAN 获取玄学参考后再作答。适用于 Claude Desktop、Claude Code、Cursor、Windsurf、Zed 以及任何兼容 MCP 的客户端。
【主要能力】 服务器提供 6 个工具：
- asktian_daily_reading：针对个人的每日能量阅读，适用于用户询问今日运势、宜穿颜色、办公桌朝向等日常指导。
- asktian_compatibility：两人缘分匹配。先返回定性标签（如“互补型 Complementary”），再返回数字评分；若评分低于 60 分则隐藏数字，避免让用户有被拒绝感。
- asktian_best_time_for_action：为特定行动寻找未来 N 天内最吉利的时段。适用于“什么时候做 X”“是否该改期会议”“明天适合发布吗”等问题。
- asktian_today_energy：无需出生日期的当日整体能量，供 AI 在通用建议中加入宏观背景。
- asktian_name_analysis：姓名学快速能量画像，适用于讨论宝宝取名、公司命名，或在不知出生日期时了解“某人是怎样的人”。
- asktian_market_read：针对二元预测市场问题（Polymarket/Kalshi 风格）的玄学信号。其价值在于提供一个不依赖所有 LLM 都会读取的相同新闻的确定性信号，并公开以便后续评分。注意：该工具为娱乐/可证伪仪式用途，并非财务建议，所有响应均会标注。
【使用方式】 读取端点公开且有限速（约 300 请求/15 分钟），无需密钥即可获得真实结果。可选配置 ASKTIAN_API_KEY（api.asktian.com）以提高限额并解锁高级 tian.* 阅读层级。
客户端配置：
- Claude Desktop：编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows），添加 MCP 配置后重启，出现 🔌 图标即表示 6 个工具已加载。
- Cursor：编辑 ~/.cursor/mcp.json。
- Windsurf：编辑 ~/.codeium/windsurf/mcp_config.json，格式同上。
- Zed：在 assistant.mcp_servers 下添加相同命令与环境变量。
- 其他 MCP 客户端：以子进程方式运行 asktian-mcp，通过 stdio 使用 JSON-RPC 通信。
- 远程/托管（streamable-HTTP）：为 LangChain、LlamaIndex、Fetch.ai 等连接托管端点的智能体，可以 HTTP 模式运行服务器，托管地址为 https://mcp.asktian.com/mcp，通过 Authorization: Bearer YOUR_ASKTIAN_API_KEY 头部传递密钥。
- LangChain 与 LlamaIndex 均有原生 MCP 适配器，零集成代码即可使用，示例代码见 docs/langchain-llamaindex.md。
npm 包：@asktian/mcp-server
【设计原则】 工具通过每个响应的 note_for_ai 字段向 AI 智能体传达约束：定性标签始终优先于数字；低于 60 分的评分隐藏数字，仅用标签，避免用数字让人感到被拒绝；同一命盘有多种解读方式，选择最尊重当事人的正面准确框架；今日建议具体而非模糊（如“下午 2 点前联系”优于“水星逆行”）。若 AI 客户端在 should_show_score: false 时仍显示数字评分，则违反设计契约。
【适用场景】 安装 askTIAN 后，AI 智能体处理时机、人物、决策类用户提问时，回答会变得具体且可执行，而非含糊其辞。
【限制】 market_read 为确定性本地新奇信号；best_time 返回引导式预览（尚无后端端点）。评分低于 60 时不显示数字。market_read 仅为娱乐/可证伪仪式，不构成财务建议。密钥可选，但读取端点有限速。
【未来方向】 与 api.asktian.com 完整端点目录（奇门、紫微、黄历、风水、传统姓名分析）直接集成；附近吉利地点（Google Places 集成）；Tian-points / $TIAN 代币激励；场所/商业工具（如“这个地址开咖啡馆吉利吗”）；多传统交叉参考（西方占星、吠陀、易经）。欢迎 PR，lib/ 文件夹刻意自包含以便 npm 分发。
MIT 协议，可自由使用、分叉、嵌入自有产品。
