Ancient Echoes

Ancient Echoes MCP

Ancient Echoes は、BaZi（四柱推命）、Zi Wei Dou Shu、Qi Men Dun Jia、Qi Zheng Si Yu、ヴェーダ占星術と西洋占星術、Liu Yao、Mei Hua、Da Liu Ren、Xiao Liu Ren、Tai Yi、暦、日取り選定の根拠を計算する、決定論的な中国占術計算機能をリモート MCP サーバーとして提供します。

計算エンジンは当社のサーバー上で稼働します。このリポジトリにはクライアント側の スキルとセットアップ手順のみが含まれているため、MCP に対応するクライアントならどれでも、同じバージョン管理されたツールを呼び出せます。

利用できる機能

すべてのツールの応答には calculationCapability / calculationVersion が含まれるため、リリースをまたいでも結果を再現できます。

公式 MCP Registry には io.github.FlamesCN/ancient-echoes-mcp として登録されています。 MCP Apps に対応するホストでは、BaZi の結果がインタラクティブなチャートとして表示されます。それ以外のホストでも、同じ構造化 JSON を取得できます。

OAuth 対応コネクターは、認可サーバーを https://www.ancientechoes.ai/.well-known/oauth-protected-resource で検出し、標準の PKCE フローで接続できます。開発者は引き続き、Authorization ヘッダーで Web API キーを使用できます。

1. API キーを取得する

https://www.ancientechoes.ai にサインインし、ユーザーセンター → LingXi Devices を開きます。

• Web API Key（sk-…）：MCP クライアントで最も簡単に使用できます。
• Device token（lxd_…）：短いコードでマシンをペアリングします。デフォルトで mcp スコープが付与され、パスワードに触れることなくローテーションまたは取り消しができます。

どちらの認証情報でも、POST /api/v1/mcp と POST /api/v1/tools/:name にアクセスできます。

2. MCP クライアントを接続する

エンドポイント：https://www.ancientechoes.ai/api/v1/mcp（Streamable HTTP）。 サーバーはプロトコルバージョン 2026-07-28、2025-11-25、2025-06-18、2025-03-26 に対応しています。

{
  "mcpServers": {
    "ancient-echoes": {
      "url": "https://www.ancientechoes.ai/api/v1/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer sk-your-key"
      }
    }
  }
}

curl -sS https://www.ancientechoes.ai/api/v1/mcp \
  -H "Authorization: Bearer $ANCIENT_ECHOES_TOKEN" \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -H "Mcp-Method: server/discover" \
  -d '{"jsonrpc":"2.0","id":1,"method":"server/discover","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28"}}}'

3. ツールを呼び出す

curl -sS https://www.ancientechoes.ai/api/v1/tools/bazi.calculate_chart \
  -H "Authorization: Bearer $ANCIENT_ECHOES_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"input_mode":"birth","year":1990,"month":6,"day":15,"hour":9,"minute":30,
       "is_male":true,"calendar_type":"solar","is_leap_month":false,
       "cast_time_source":"birth","timezone_id":"Asia/Shanghai",
       "split_zi_hour":true,"use_true_time":false,"apply_dst":false}'

重要なルール：

• 明示的な現地時刻、暦、タイムゾーンを指定してください。また、真太陽時を使用する場合は座標も指定してください。 サーバーが不足している項目を自身の時計やデフォルトの都市で補うことはありません。
• 有料ツールは、プランに機能が含まれていない場合、tool_entitlement_required を返します。
• クォータ：デフォルトではユーザーごとに1日あたり200回、1分あたり30回のツール呼び出しが可能です（超過すると 429 と tool_quota_exceeded が返されます）。
• 現在のすべてのツールは読み取り専用です。結果は人が読むための根拠であり、医療、法律、投資、人生の決断に関する助言ではありません。

セルフホスト可能な stdio ブリッジ（Docker）

MCP を stdio 経由でのみ利用するクライアントやレジストリは、このリポジトリの ブリッジを実行できます。このブリッジには計算エンジンが含まれていません。initialize、ping、tools/list は、同梱カタログ（公開 OpenAPI ドキュメントから生成された 38 個のツール）に基づいてローカルで応答し、tools/call はお客様自身の認証情報を使用して POST /api/v1/tools/<name> に転送されます。

docker build -t ancient-echoes-mcp .
printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
  | docker run --rm -i ancient-echoes-mcp

tools/call を有効にするには、ANCIENT_ECHOES_TOKEN（Web API キーまたはデバイストークン）を設定してください。設定しない場合、ブリッジはディスカバリーリクエストに応答し、実行に対して明示的な isError の結果を返します。ANCIENT_ECHOES_BASE_URL と ANCIENT_ECHOES_TIMEOUT_MS でエンドポイントとタイムアウトを上書きできます。

スキル

ancient-echoes-mcp/SKILL.md では、ツールの検出、必要最小限のパラメーターの収集、利用権限の尊重、予測を捏造せずに結果を報告する方法をエージェントに説明しています。エージェントのスキルディレクトリに配置してください。

ライセンス

MIT。サーバー側のエンジン、ナレッジベース、データセットはこのリポジトリに含まれていません。