Bibliomantic MCP Server

Instructions

Implementation Reference

• bibliomantic_fastmcp.py:329-364 (handler)

  Handler function for the server_statistics tool. Automatically registered via @mcp.tool() decorator in FastMCP. Returns formatted statistics about the bibliomantic server.
  def server_statistics() -> str: """ Get bibliomantic server statistics and system information. Provides information about the server's capabilities, the I Ching database, and divination system status. Returns: Complete server statistics and system information """ stats = diviner.get_divination_statistics() return f"""📊 **Bibliomantic Server Statistics** **System Status:** {stats['system_status'].title()} **Total Hexagrams:** {stats['total_hexagrams']} **Divination Method:** {stats['divination_method']} **Randomness Source:** {stats['randomness_source']} **Bibliomantic Approach:** {stats['bibliomantic_approach']} **Server Capabilities:** - I Ching Divination (traditional three-coin method) - Bibliomantic Consultation (Philip K. Dick approach) - Hexagram Details Lookup (all 64 hexagrams) - Resource Access (hexagram database and individual entries) - Prompt Templates (career, creative, and general guidance) **Framework:** FastMCP (Official MCP Python SDK) **Protocol Version:** MCP 2024-11-05 **Transport:** Standard I/O (stdio) **Historical Context:** This server implements the bibliomantic divination approach described in Philip K. Dick's "The Man in the High Castle", combining ancient I Ching wisdom with modern AI capabilities for guided decision-making."""
• bibliomantic_fastmcp_ethical.py:350-392 (handler)

  Handler function for the server_statistics tool in the ethical variant. Automatically registered via @mcp.tool() decorator. Includes ethical framework in statistics.
  def server_statistics() -> str: """ Get bibliomantic server statistics and system information. Provides information about the server's capabilities, the I Ching database, and divination system status. Returns: Complete server statistics and system information with ethical context """ stats = diviner.get_divination_statistics() return f"""📊 **Bibliomantic Server Statistics** **System Status:** {stats['system_status'].title()} **Total Hexagrams:** {stats['total_hexagrams']} **Divination Method:** {stats['divination_method']} **Randomness Source:** {stats['randomness_source']} **Bibliomantic Approach:** {stats['bibliomantic_approach']} **Server Capabilities:** - I Ching Divination (traditional three-coin method) - Bibliomantic Consultation (Philip K. Dick approach) - Hexagram Details Lookup (all 64 hexagrams) - Resource Access (hexagram database and individual entries) - Prompt Templates (career, creative, and general guidance) **Ethical Framework:** - All responses include appropriate disclaimers - Educational and philosophical focus maintained - No supernatural or predictive claims made - Users guided toward professional consultation for important decisions **Framework:** FastMCP (Official MCP Python SDK) **Protocol Version:** MCP 2024-11-05 **Transport:** Standard I/O (stdio) **Historical Context:** This server implements the bibliomantic divination approach described in Philip K. Dick's "The Man in the High Castle", combining ancient I Ching wisdom patterns with modern AI capabilities for philosophical exploration and creative reflection."""
• enhanced_bibliomantic_server.py:391-442 (handler)

  Enhanced handler function for the server_statistics tool. Automatically registered via @mcp.tool(). Provides detailed statistics including enhanced features status.
  def server_statistics() -> str: """Enhanced server statistics""" stats = diviner.get_divination_statistics() enhanced_features = "" if ENHANCED_MODE: enhanced_features = """ **Enhanced Features:** - Traditional Chinese names and Unicode symbols - Complete judgment and image texts - Changing line interpretations - Trigram analysis and interactions - Contextual interpretations (career, relationships, creative, business, personal) - Traditional and modern commentary - King Wen sequence binary mapping - Context-aware query analysis""" return f"""📊 **Enhanced Bibliomantic Server Statistics** **System Status:** {stats['system_status'].title()} **Enhanced Mode:** {"Active" if ENHANCED_MODE else "Compatibility Mode"} **Total Hexagrams:** {stats['total_hexagrams']} **Divination Method:** {stats['divination_method']} **Randomness Source:** {stats['randomness_source']} **Bibliomantic Approach:** {stats['bibliomantic_approach']}{enhanced_features} **Server Capabilities:** - Enhanced I Ching Divination (traditional three-coin method with changing lines) - Rich Bibliomantic Consultation (Philip K. Dick approach with full traditional elements) - Complete Hexagram Details (all 64 with Chinese names and Unicode symbols) - Enhanced Resource Access (hexagram database with traditional content) - Contextual Prompt Templates (career, creative, and general guidance) **Ethical Framework:** - All responses include appropriate disclaimers - Educational and philosophical focus maintained - No supernatural or predictive claims made - Users guided toward professional consultation for important decisions **Framework:** FastMCP (Official MCP Python SDK) **Protocol Version:** MCP 2024-11-05 **Transport:** Standard I/O (stdio) **Historical Context:** This enhanced server implements the bibliomantic divination approach described in Philip K. Dick's "The Man in the High Castle", combining authentic traditional I Ching wisdom with modern AI capabilities for deep philosophical exploration and creative reflection. **Quality Enhancement:** Traditional interpretations now include judgment, image, changing lines, trigram analysis, contextual guidance, and multiple commentary perspectives for authentic I Ching experience."""