asktian

asktian MCP 服务

在 AI 助手中融入中国玄学。 不知道就问天 · Ask tian when you don't know.

将 4000 年的中国玄学传统（八字、奇门、五行、每日干支能量）作为可调用工具，提供给任何遵循 Model Context Protocol 的 AI Agent——Claude Desktop、Claude Code、Cursor、Windsurf、Zed，以及任何兼容 MCP 的客户端。

当你向 AI 助手询问有关时机、人际关系或决策的问题时，它可以在回答前悄悄咨询 asktian。

AI Agent 的决策层。 Agent 已经接入了搜索、记忆和支付功能——askTIAN 则为它们提供立场：给出具体、可证伪的判断，而不是一句“视情况而定”。→ 为何它有市场 · 2 分钟快速入门

✨ 真实解读，无需密钥。

这些工具会调用 askTIAN 实时后端并返回真实结果——每日黄历、命理契合度、 姓名分析、每日能量，开箱即用。读取接口 公开且有速率限制（约 300 次请求 / 15 分钟）。可选的 ASKTIAN_API_KEY (api.asktian.com) 可提高限额并解锁高级 tian.* 解读层级。market_read 是一个确定性的本地新奇度信号；best_time 返回引导式预览（目前还没有对应的后端接口）。

You: "I have a hard conversation with my boss tomorrow at 3pm. Should I move it?"

Claude (with asktian MCP):
  → calls asktian_best_time_for_action({ birthdate, action: "difficult_conversation" })
  → "Friday 10am scores much higher. Tomorrow 3pm is your clash hour.
     Want me to draft a message to reschedule?"

---

安装

npm install -g @asktian/mcp-server

然后将其添加到客户端的 MCP 配置中：

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "asktian": {
      "command": "asktian-mcp",
      "env": {
        "ASKTIAN_API_KEY": "at_live_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

重启 Claude Desktop。查看 🔌 图标——asktian 应显示为 6 个工具。

Cursor

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

{
  "mcpServers": {
    "asktian": {
      "command": "asktian-mcp",
      "env": {
        "ASKTIAN_API_KEY": "at_live_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json——格式与上面相同。

Zed

在 Zed 设置中的 assistant.mcp_servers 下添加——命令和环境变量相同。

其他 MCP 客户端

将 asktian-mcp 作为子进程运行；它遵循 MCP 规范，通过 stdio 使用 JSON-RPC 通信。

远程 / 托管（可流式传输的 HTTP）

对于 LangChain、LlamaIndex、Fetch.ai，或任何连接到托管 MCP 端点的 Agent， 请以 HTTP 模式而非 stdio 运行服务：

ASKTIAN_MCP_HTTP=1 PORT=8080 npx -y @asktian/mcp-server
# → streamable-HTTP on :8080/mcp   (health check: GET :8080/health)

托管地址为 https://mcp.asktian.com/mcp。将密钥作为 Bearer 标头传入： Authorization: Bearer YOUR_ASKTIAN_API_KEY。

LangChain 和 LlamaIndex

两者都内置了 MCP 适配器——askTIAN 无需编写任何集成代码即可使用。可复制粘贴的 代码片段见 docs/langchain-llamaindex.md。

---

API 密钥

密钥为可选项——无论是否使用密钥，解读都是真实的。

	🆓 无需密钥（默认）	🔑 使用密钥
设置	无需设置——立即可用	在 api.asktian.com 获取密钥
解读	真实——来自 api.asktian.com 实时后端（每日黄历、契合度、姓名分析、每日能量）	相同的真实解读
速率限制	约 300 次请求 / 15 分钟（按 IP 计算）	更高的限额
高级 tian.* 层级	—	已解锁
费用	免费	按密钥对应的套餐收费

使用密钥（提高限额并解锁高级层级），请在客户端配置中设置 ASKTIAN_API_KEY：

{
  "mcpServers": {
    "asktian": {
      "command": "npx",
      "args": ["-y", "@asktian/mcp-server"],
      "env": { "ASKTIAN_API_KEY": "at_live_..." }   // ← omit this line to stay in local mode
    }
  }
}

托管模式（可流式传输的 HTTP）？请改为通过标头传入：Authorization: Bearer at_live_...。

---

6 个工具

1. asktian_daily_reading

为个人提供个性化每日能量解读。

input:  { birthdate: "1992-05-15", birth_hour?: "14:30", gender?: "male"|"female"|"any" }
output: archetype (one of 8 trigrams), today's stem-branch energy,
        favorable colors / direction / hours, headline + body advice

适用场景： 用户询问今天运势如何、穿什么颜色、书桌朝哪个方向摆放，以及每日指引。

2. asktian_compatibility

两个人之间的命理契合度。先返回定性标签（例如 "互补型 Complementary"），然后返回数值评分（根据 asktian 的设计原则，低于 60 时隐藏——契合度较低绝不应让人觉得被拒绝）。

input:  { person_a_birthdate, person_b_birthdate, dimension?: "love"|"career"|"friend"|"general" }
output: qualitative label, category, element flow, today's advice, score (with should_show_score flag)

适用场景：“我和这个人合得来吗”、“检查契合度”、“这是一对合适的组合吗”。

3. asktian_best_time_for_action

核心工具。查找未来 N 天内适合采取特定行动的最佳时段。

input:  { birthdate, action: "difficult_conversation"|"negotiation"|"launch"|... , range_days?: 7 }
output: top 3 best windows (date + hour + score + reason), windows to avoid

适用场景：“我应该什么时候做 X”、“要不要改一下这场会议”、“明天适合发布吗”、“我应该什么时候进行那场艰难的谈话”。

4. asktian_today_energy

当天的整体能量——无需出生日期。

input:  { date?: "YYYY-MM-DD" } (defaults to today)
output: 干支 stem+branch, dominant 5-element character, description

**适用场景：**AI 想为一般性建议补充宇宙背景，又不需要用户的出生日期。

5. asktian_name_analysis

快速分析名字的能量特征（姓名学）。

input:  { name, language?: "en"|"zh"|"auto" }
output: dominant element guess, tone, one-liner

**适用场景：**讨论婴儿名字、公司名称，或在不知道出生日期时询问“X 是什么样的人”。

6. asktian_market_read

针对二元预测市场问题（Polymarket/Kalshi 风格）的中国玄学信号。

input:  { question, resolve_date?: YYYY-MM-DD, subject_birthdate?: YYYY-MM-DD }
output: { signal: { lean: yes|no|neutral, score 5–95, confidence }, reasoning, disclaimer }

适用场景：用户或交易 Agent 想要了解市场的不相关、娱乐性解读—— “X 会在 Y 日期前发生吗”。其价值不在于预测，而在于提供一种不依赖所有大模型都在读取的相同新闻的确定性信号，并公开发布结果，以便随着时间推移对这些判断进行评分。 ⚠️ 仅供娱乐／可证伪的仪式——不是财务建议。 每个回复都会说明这一点，而且该工具旨在作为新奇体验呈现，绝不应被当作下注建议。

---

工具遵循的设计原则

asktian 有自己的主张。MCP 工具通过每个响应中的 note_for_ai 字段，将这些约束告知你的 AI Agent。主要规则：

1. 始终优先采用定性标签。 数字是次要的。
2. 低于 60 分时隐藏数字。 只使用标签——绝不要让人因为一个数字而觉得被拒绝。
3. 采用最积极且准确的表述。 同一张命盘可以有 5 种解读方式；选择尊重当事人的那一种。
4. 今日建议应具体，而非含糊。 “下午 2 点前联系对方”胜过“水星逆行”。

如果你的 AI 客户端在 should_show_score: false 时仍显示数值评分，就违反了设计约定。

---

示例——会路由到 asktian 的提示词

以下是安装了 asktian 的 AI Agent 能够处理得好得多的用户提示词：

用户提示词	AI 将使用的工具
“我今天运势如何？出生日期是 1992-05-15。”	asktian_daily_reading
“我明天下午 3 点要和一位难相处的客户开会。要改时间吗？”	asktian_best_time_for_action
“我的伴侣出生于 1990-08-22，我出生于 1992-05-15。我们作为伴侣合适吗？”	asktian_compatibility
“今天是怎样的一天？”	asktian_today_energy
“‘Aurora’ 适合作为我的初创公司的名字吗？”	asktian_name_analysis
“什么时候最适合发布我的产品？我的出生日期是……”	asktian_best_time_for_action
“我这个月应该向伴侣求婚吗？我的出生日期是 1992-05-15，对方的是 1990-08-22。”	asktian_best_time_for_action + asktian_compatibility

在每种情况下，Agent 的回复都会变得具体且可执行，而不是含糊其辞。

---

路线图

• 直接集成完整的 api.asktian.com 端点目录（奇门、紫微、黄历、风水、传统姓名学）
• 查找我附近的吉利地点（集成 Google Places）
• 为高频使用提供 Tian-points／$TIAN 代币奖励
• 面向场所／企业的工具：“这个地址适合开咖啡馆吗”
• 多种传统交叉参考（西方占星学、吠陀占星、易经）——同一个人，多种视角

欢迎提交 PR。lib/ 文件夹特意设计为独立封装，以便干净地分发 npm 包。

---

链接

• API 与文档（可选密钥 — 更高限额 + 高级套餐）： api.asktian.com
• $TIAN 代币 + 钱包： wallet.asktian.com
• 源代码： github.com/douglasgan/asktian-mcp

---

许可证

MIT — 可在任何地方使用、分叉，并将其集成到自己的产品中。 asktian 协议旨在成为公共基础设施。

不知道就问天.