Bibliomantic MCP Server

🚀 易經占卜MCP服務器

這是一個模型上下文協議（MCP）服務器，它將易經占卜與人工智能響應相結合，探索菲利普·K·迪克（Philip K. Dick）在《高堡奇人》（The Man in the High Castle）中描述的占卜方法。該服務器通過MCP展示瞭如何將傳統智慧系統與現代人工智能進行巧妙融合，為用戶提供了多方面的價值。

🚀 快速開始

本服務器藉助MCP展示瞭如何將傳統智慧系統與現代人工智能進行巧妙融合。它提供了以下內容：

• 對中國古代哲學和《易經》的教育性探索。
• 菲利普·K·迪克有影響力的科幻作品中的文學背景。
• 用於創造性思維和換位思考的哲學反思工具。
• 藉助工具、資源和提示展示FastMCP能力的技術演示。

✨ 主要特性

• 傳統易經系統：具備全部64卦，採用正宗的三枚硬幣法模擬。
• 占卜諮詢：遵循菲利普·K·迪克在《高堡奇人》中的方法。
• FastMCP實現：專業符合MCP標準，配備工具、資源和提示。
• 道德保障：明確聲明僅用於娛樂和反思目的。
• 教育背景：每次諮詢都提供歷史和哲學背景信息。
• 資源訪問：可直接訪問卦象數據庫，用於加載人工智能上下文。

📦 安裝指南

前提條件

• Python 3.10+（MCP SDK要求）
• 兼容MCP的主機（如Claude Desktop等）

使用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} - 加載單個卦象數據以用於人工智能上下文。
• iching://database - 訪問完整的64卦數據庫概述。

提示模板

• career_guidance_prompt - 用於職業決策的結構化提示。
• creative_guidance_prompt - 用於藝術和創意項目的提示。
• general_guidance_prompt - 通用的生活指導模板。

💻 使用示例

基礎用法

詢問Claude：

“你能為我的創意項目進行一次《易經》占卜，以獲得哲學指導嗎？”

高級用法

占卜諮詢

“我在職業道路上面臨一個艱難的決定。你能使用占卜方法諮詢《易經》嗎？”

資源訪問

“加載hexagram://1資源以瞭解《乾卦》。”

特定卦象查詢

“你能告訴我《易經》第42卦的信息嗎？”

🔧 技術細節

占卜方法

本實現遵循菲利普·K·迪克在《高堡奇人》中描述的占卜方法，書中角色諮詢《易經》以獲得重要決策的指導。該系統：

• 使用傳統的《易經》三枚硬幣拋擲方法。
• 生成加密安全的隨機數，以實現真實的占卜。
• 將古代智慧與現代人工智能能力相結合。
• 保持占卜的哲學和反思性。
• 在占卜過程中提供透明度。

技術實現

該服務器基於以下技術構建：

• FastMCP - 官方MCP Python SDK，確保專業合規。
• 傳統《易經》 - 完整的64卦數據庫，帶有正宗解釋。
• 加密隨機數 - 使用Python的secrets模塊進行安全的三枚硬幣模擬。
• 類型安全 - 完整的類型提示，自動生成JSON模式。
• 道德保障 - 所有響應中都包含面向用戶的免責聲明。

📄 許可證

本項目採用MIT許可證，詳情請參閱LICENSE文件。

其他說明

用例

• 教育工具：用於學習《易經》哲學和中國智慧傳統。
• 創意寫作輔助：用於產生新的視角和靈感。
• 哲學反思工具：用於思考人生決策和變化。
• 文化橋樑：連接古代智慧與現代人工智能能力。
• 技術演示：展示帶有文化內容的MCP服務器開發。
• 文學分析：分析菲利普·K·迪克的主題和占卜概念。

安全考慮

• 對所有用戶查詢和參數進行輸入驗證。
• 無外部網絡請求或API依賴。
• 加密安全的隨機數生成。
• 明確的道德界限和用戶教育。
• 無持久數據存儲或用戶跟蹤。

貢獻

歡迎貢獻代碼！請遵循以下步驟：

1. 遵循現有的代碼風格和模式。
2. 使用MCP Inspector為新功能添加測試。
3. 為任何更改更新文檔。
4. 確保與官方MCP SDK兼容。
5. 維護道德框架和教育重點。

致謝

• 菲利普·K·迪克：提供文學靈感和占卜方法。
• 中國古代哲學家：傳承《易經》智慧傳統。
• Anthropic：提供模型上下文協議和FastMCP框架。
• MCP社區：推動創新的人工智能集成。

“神諭是正確的。未來仍在前方。” - 菲利普·K·迪克，《高堡奇人》