ming-metaphysics-mcp

Claude DesktopおよびMCP互換クライアント向けの、5つの中国形而上学エンジンを統合したMCPツールです。

Cantianのbazi-mcpとの比較

ツール

エンジンの要件

本パッケージはMCPのラッパーです。形而上学的な計算ロジック自体は含んでおらず、ツール呼び出しをHTTP経由でMingエンジンエンドポイントに転送します。使用するには、MING_API_URLを実行中のエンジンに向けてください。

エンジンを入手する方法は2つあります：

1. ホストされたエンドポイント（推奨）。公開されているMingエンドポイントが発表される予定です。利用可能になったら、MING_API_URLをそこに設定するだけで完了です。

2. セルフホスト。Mingエンジン自体は現在クローズドソースのリファレンス実装です。Mingのコードベースにアクセスできる場合は、uvicorn api.main:app --port 8000を実行し、このMCPをlocalhost:8000に向けてください。

到達可能なエンジンがない場合、MCPサーバーは起動してツールをリストアップしますが、ツール呼び出しはHTTPエラーを返します。

インストール

ステップ 1 — エンジンが到達可能であることを確認する

上記の「エンジンの要件」を参照してください。

ステップ 2 — MCPサーバーをインストールする

npm install -g ming-metaphysics-mcp

ステップ 3 — claude_desktop_config.jsonに追加する

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ming": {
      "command": "ming-metaphysics-mcp",
      "args": [],
      "env": {
        "MING_API_URL": "http://localhost:8000"
      }
    }
  }
}

Claude Desktopを再起動します。Mingツールがツールリストに表示されます。

検証

Claude Desktopにて：

Using the ming_bazi_analyze tool, analyze the chart for someone born 1990-03-15, male, in Singapore.

完全な八字の読み解き結果が得られるはずです。ツールがエラーになる場合は、Pythonエンジンがポート8000で実行されていることを確認してください。

エンドポイントのギャップ

以下の機能は、指定通りに完全に機能させるためにFastAPIの拡張が必要です。それぞれツール応答に注記がフラグ立てされており、サイレントエラーは発生しません。

年次飛星やforecast_yearのサポートを実装するには、api/main.pyの/consultにそれらのパラメータを追加し、ここにある対応するツールハンドラーを更新してください。

開発

git clone <this-repo>
cd ming-metaphysics-mcp
npm install
npm run build          # compile TypeScript → dist/
npm test               # smoke tests (no engine required)

# With engine running at localhost:8000:
npx ts-node scripts/benchmark.ts --tool all --iterations 5

環境変数

レイテンシ目標

いずれかのツールが継続的に5秒を超える場合は、エンジンのボトルネックを確認し、MCP設定にtimeout: 10000を追加することを検討してください。

認証

ラッパーレベルでは認証はありません。このサーバーはオープンソースで無料（MITライセンス）です。認証が必要な場合は、MING_API_URLが指すエンドポイント側で強制されます。

5つのエンジンによる完全な鑑定のために

5つのエンジンによるガイド付き鑑定（八字 + 紫微斗数 + 奇門遁甲 + 風水 + 易経を陳マスターが統合）は、MingのTelegramボット経由で利用可能です。ボットがパブリックベータ版になった時点でリンクが公開されます。

プライバシー

このMCPラッパー自体はデータを収集しません。ツール引数（生年月日、時間、性別、質問内容）を、設定したMING_API_URLに転送するだけです。ホストされたエンドポイントを指定した場合、そのエンドポイントがデータを受け取ります。そのプライバシーポリシーを確認してください。セルフホストしている場合、データはネットワークの外には出ません。

出生データは機密情報です。エンドユーザー向けにこれを設定する場合は、どのエンドポイントが入力データを受け取るかを明確にしてください。

プロジェクトステータス

このパッケージはバージョン1.0.0です。MCPプロトコルのインターフェース（6つのツール、JSONスキーマ、応答形式）は安定しています。基盤となるMingエンジンはより速く進化するため、ツール応答の数値に軽微な変更があるのは正常です。

貢献を歓迎します — CONTRIBUTING.mdを参照してください。

ライセンス

MIT — LICENSEを参照してください。