Bibliomantic MCP Server

🚀 占い的MCPサーバー

易経占いとAI応答を統合したモデルコンテキストプロトコル（MCP）サーバーです。フィリップ・K・ディックの『高い城の男』に記載された占い的アプローチを探索します。

🚀 クイックスタート

このサーバーは、MCPを通じて伝統的な知恵システムと現代のAIを深思熟慮して統合する方法を示します。以下の機能を提供します。

• 古代中国哲学と易経の教育的探索
• フィリップ・K・ディックの影響力のあるサイエンスフィクション作品からの文学的コンテキスト
• 創造的思考と視点の取得のための哲学的反省ツール
• ツール、リソース、プロンプトを備えたFastMCP機能の技術的デモンストレーション

✨ 主な機能

• 伝統的な易経システム：本物の三銭法シミュレーションを備えた全64卦
• 占い的相談：『高い城の男』からのフィリップ・K・ディックのアプローチに従う
• FastMCP実装：ツール、リソース、プロンプトを備えた専門的なMCP準拠
• 倫理的保護措置：娯楽/反省目的に関する明確な免責事項
• 教育的コンテキスト：各相談の歴史的および哲学的背景
• リソースアクセス：AIコンテキストロードのための直接的な卦データベースアクセス

📦 インストール

uvxを使用する（推奨）

uvx bibliomantic-mcp-server

pipを使用する

pip install bibliomantic-mcp-server

ソースから

git clone https://github.com/dshields/bibliomantic-mcp-server.git
cd bibliomantic-mcp-server
pip install -e .

Claude Desktopの設定

claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "bibliomantic": {
      "command": "uvx",
      "args": ["bibliomantic-mcp-server"]
    }
  }
}

代替設定：

{
  "mcpServers": {
    "bibliomantic": {
      "command": "python",
      "args": ["-m", "bibliomantic_server"]
    }
  }
}

利用可能なツール

• i_ching_divination - 伝統的な解釈付きでランダムな卦を生成
• bibliomantic_consultation - クエリ拡張を伴う完全な占い的プロセス
• get_hexagram_details - 番号（1 - 64）で特定の卦を検索
• server_statistics - システム情報と機能を表示

リソース

• hexagram://{number} - AIコンテキスト用に個々の卦データをロード
• iching://database - 完全な64卦データベースの概要にアクセス

プロンプトテンプレート

• career_guidance_prompt - キャリア決定のための構造化されたプロンプト
• creative_guidance_prompt - 芸術的および創造的なプロジェクトのためのプロンプト
• general_guidance_prompt - 普遍的な人生ガイダンステンプレート

💻 使用例

基本的な使用法

Claudeに尋ねる：

"創造的なプロジェクトに関する哲学的なガイダンスのために、易経占いを行ってもらえますか？"

高度な使用法

"私はキャリアパスに関して難しい決断を迫られています。占い的アプローチを使って易経に相談してもらえますか？"

リソースアクセス

"創造の卦を理解するために、hexagram://1リソースをロードしてください。"

特定の卦の検索

"易経の42番目の卦について教えてもらえますか？"

占い的アプローチ

この実装は、フィリップ・K・ディックの『高い城の男』に記載された占い方法に従います。ここでは、登場人物が重要な決断に関するガイダンスのために易経に相談します。このシステムは：

• 三銭投げを用いた伝統的な易経方法論を使用
• 本物の占いのために暗号学的に安全な乱数生成を行う
• 古代の知恵と現代のAI機能を統合する
• 占い的アプローチの哲学的および反省的な側面を維持する
• 占いプロセスの透明性を提供する

倫理的枠組み

すべての応答には、これが哲学的な反省と娯楽のみを目的としており、超自然的なガイダンスや人生相談ではないという明確な免責事項が含まれています。ユーザーは重要な決断に関しては適格な専門家に相談するように指示されます。

このサーバーは以下を強調します：

• 知恵の伝統の教育的探索
• 創造的思考と視点の取得
• 予測ではなく哲学的な反省
• 古代の伝統と現代の倫理基準の両方への尊重

開発

MCPインスペクターでのテスト

mcp dev bibliomantic_server.py

ローカルでの実行

python bibliomantic_server.py

🔧 技術詳細

• FastMCP - 専門的な準拠のための公式MCP Python SDK
• 伝統的な易経 - 本物の解釈付きの完全な64卦データベース
• 暗号学的乱数生成 - Pythonのsecretsモジュールを使用した安全な三銭シミュレーション
• 型安全性 - 自動JSONスキーマ生成を伴う完全な型ヒント
• 倫理的保護措置 - すべての応答にユーザー向けの免責事項

ユースケース

• 易経哲学と中国の知恵伝統を学ぶための教育ツール
• 新しい視点とインスピレーションを生み出すための創作支援ツール
• 人生の決断や変化を熟考するための哲学的反省ツール
• 古代の知恵と現代のAI機能の間の文化的架け橋
• 文化的内容を持つMCPサーバー開発の技術的デモンストレーション
• フィリップ・K・ディックのテーマと占い的概念の文学的分析

セキュリティに関する考慮事項

• すべてのユーザークエリとパラメータの入力検証
• 外部ネットワーク要求やAPI依存関係なし
• 暗号学的に安全な乱数生成
• 明確な倫理的境界とユーザー教育
• 永続的なデータ保存やユーザー追跡なし

コントリビュート

コントリビューションは歓迎されます！以下のことをお願いします。

1. 既存のコードスタイルとパターンに従う
2. MCPインスペクターを使用して新機能のテストを追加する
3. 変更に関するドキュメントを更新する
4. 公式MCP SDKとの互換性を確保する
5. 倫理的枠組みと教育的焦点を維持する

📄 ライセンス

MITライセンス - 詳細についてはLICENSEファイルを参照してください。

謝辞

• 文学的なインスピレーションと占い的アプローチを提供してくれたフィリップ・K・ディック
• 易経の知恵伝統を残してくれた古代中国の哲学者たち
• モデルコンテキストプロトコルとFastMCPフレームワークを提供してくれたAnthropic
• 革新的なAI統合を促進してくれたMCPコミュニティ

"神託は正しかった。未来はまだ先にある。" - フィリップ・K・ディック、『高い城の男』