asktian

asktian MCP サーバー

AI アシスタントに中国の形而上学を。 わからないことは天に尋ねよう · わからないときは tian に尋ねてください。

4000 年にわたる中国の形而上学の伝統（bazi / 八字、qimen / 奇门、五行、日々の干支のエネルギー）を、Model Context Protocol に対応するあらゆる AI エージェントで呼び出せるツールとして追加します。Claude Desktop、Claude Code、Cursor、Windsurf、Zed など、MCP 対応クライアントで利用できます。

AI アシスタントにタイミング、人間関係、または意思決定について尋ねると、回答の前に askTIAN にさりげなく相談できます。

AI エージェントの意思決定レイヤーです。 エージェントはすでに検索、メモリー、決済を組み込んでいます。askTIAN は、エージェントに「立場」を与えるレイヤーです。「場合によります」ではなく、具体的で反証可能な判断を示します。→ 選ばれる理由 · 2 分で始める

✨ 本格的な鑑定を、API キー不要で利用できます。

ツールは askTIAN のライブバックエンドを呼び出し、日々の暦、運勢の相性、名前の分析、日のエネルギーなどの実際の結果を、そのまま返します。読み取りエンドポイントは公開されており、レート制限があります（15 分あたり約 300 リクエスト）。任意の 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 エンドポイントに接続するエージェントでは、stdio の代わりに HTTP モードでサーバーを実行します。

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 のライブバックエンドを利用します（日々の暦、相性、名前の分析、日のエネルギー）	同じ本格的な鑑定
レート制限	15 分あたり約 300 リクエスト（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

2人の運命の相性を調べます。まず定性的なラベル（例："互补型 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

**使用する場面：**ユーザーの生年月日を必要とせずに、一般的な提案に宇宙的な背景を加えたい場合。

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 }

**使用する場面：**ユーザーやトレーディングエージェントが、市場に対して相関性のない、娯楽目的の見立てを求めるとき―― 「日付YまでにXは起こる？」。価値は予測ではなく、どのLLMも読んでいる同じニュースを読まない、決定論的なシグナルを示し、経時的に結果を評価できるように公開することです。 ⚠️ **娯楽目的／反証可能な儀式であり、金融アドバイスではありません。**すべての応答でその旨を伝えます。また、このツールは目新しさを楽しむものとして提示するよう設計されており、賭けの推奨として提示することはありません。

---

ツールが従う設計原則

asktianは明確な方針を持っています。MCPツールは、各応答のnote_for_aiフィールドを通じて、これらの制約をAIエージェントに伝えます。主なルールは次のとおりです。

1. **定性的なラベルを常に優先します。**数値は二次的なものです。
2. **60未満のスコアでは数値を非表示にします。**ラベルだけを使用し、数字で相手に拒絶されたと感じさせてはいけません。
3. **正確さを保ちつつ、最も前向きな表現を選びます。**同じチャートでも5通りの読み方ができます。相手を尊重する解釈を選んでください。
4. 今日のアドバイスは具体的にし、曖昧にしません。「午後2時までに連絡しましょう」は「水星逆行中です」よりも役に立ちます。

AIクライアントがshould_show_score: falseのときに数値スコアを表示する場合、設計上の契約に違反しています。

---

使用例 — asktianを介して実行するプロンプト例

asktianをインストールしたAIエージェントなら、次のようなユーザープロンプトに、より具体的に対応できます。

ユーザープロンプト	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

どの場合も、エージェントの応答は曖昧なものではなく、具体的で実行に移しやすいものになります。

---

ロードマップ

• api.asktian.comのエンドポイントカタログ全体（qimen、ziwei、暦、風水、伝統的な姓名分析）との直接連携
• 近くの吉方位（Google Placesとの連携）
• ヘビーユーザー向けのTianポイント／$TIANトークンのインセンティブ
• 会場／ビジネス向けツール：「この住所はカフェに縁起がいいですか？」
• 複数の伝統的占術の相互参照（西洋占星術、ヴェーダ占星術、易経）――同じ人を複数の視点から分析

PRを歓迎します。lib/フォルダーは、npmでクリーンに配布できるよう、意図的に自己完結型にしています。

---

リンク

• API とドキュメント（キーは任意 — 上限緩和＋プレミアムティア）： api.asktian.com
• $TIAN トークンとウォレット： wallet.asktian.com
• ソース： github.com/douglasgan/asktian-mcp

---

ライセンス

MIT — どこでも使用でき、フォークして、ご自身の製品に組み込んで公開できます。 asktian プロトコルは、公開インフラストラクチャとして設計されています。

わからないことは天に聞いてください。