Bibliomantic MCP Server

Instructions

Implementation Reference

• bibliomantic_fastmcp.py:91-137 (handler)

  Primary handler function for the 'bibliomantic_consultation' MCP tool. Decorated with @mcp.tool() for automatic registration. Performs I Ching divination via BiblioManticDiviner and formats the response.
  @mcp.tool() def bibliomantic_consultation(query: str) -> str: """ Perform bibliomantic consultation following Philip K. Dick's approach. Augments your query with I Ching wisdom, creating a bridge between your specific question and ancient guidance, as described in "The Man in the High Castle". Args: query: The question or situation requiring guidance Returns: Complete bibliomantic consultation with hexagram wisdom """ logger.info(f"Performing bibliomantic consultation for query: {query[:50]}...") if not query.strip(): return "Please provide a question for bibliomantic consultation." # Perform divination and augment query augmented_query, divination_info = diviner.divine_query_augmentation(query) if "error" in divination_info: error_msg = f"Consultation failed: {divination_info['error']}" logger.error(error_msg) return error_msg response = f"""🔮 **Bibliomantic Consultation** **Your Question:** {query} **Oracle's Guidance - Hexagram {divination_info['hexagram_number']}: {divination_info['hexagram_name']}** {divination_info['interpretation']} **Bibliomantic Integration:** The I Ching suggests considering this wisdom in the context of your question. This ancient guidance offers perspective on the energies and patterns surrounding your situation. **Method:** Traditional three-coin divination **Approach:** Philip K. Dick's bibliomantic method from "The Man in the High Castle" **Randomness:** Cryptographically secure generation *This consultation bridges your modern question with timeless wisdom, allowing the oracle to speak to your specific circumstances.*""" logger.info(f"Completed bibliomantic consultation with hexagram {divination_info['hexagram_number']}") return response
• bibliomantic_fastmcp.py:91-137 (registration)

  The @mcp.tool() decorator registers this function as an MCP tool named 'bibliomantic_consultation'.
  @mcp.tool() def bibliomantic_consultation(query: str) -> str: """ Perform bibliomantic consultation following Philip K. Dick's approach. Augments your query with I Ching wisdom, creating a bridge between your specific question and ancient guidance, as described in "The Man in the High Castle". Args: query: The question or situation requiring guidance Returns: Complete bibliomantic consultation with hexagram wisdom """ logger.info(f"Performing bibliomantic consultation for query: {query[:50]}...") if not query.strip(): return "Please provide a question for bibliomantic consultation." # Perform divination and augment query augmented_query, divination_info = diviner.divine_query_augmentation(query) if "error" in divination_info: error_msg = f"Consultation failed: {divination_info['error']}" logger.error(error_msg) return error_msg response = f"""🔮 **Bibliomantic Consultation** **Your Question:** {query} **Oracle's Guidance - Hexagram {divination_info['hexagram_number']}: {divination_info['hexagram_name']}** {divination_info['interpretation']} **Bibliomantic Integration:** The I Ching suggests considering this wisdom in the context of your question. This ancient guidance offers perspective on the energies and patterns surrounding your situation. **Method:** Traditional three-coin divination **Approach:** Philip K. Dick's bibliomantic method from "The Man in the High Castle" **Randomness:** Cryptographically secure generation *This consultation bridges your modern question with timeless wisdom, allowing the oracle to speak to your specific circumstances.*""" logger.info(f"Completed bibliomantic consultation with hexagram {divination_info['hexagram_number']}") return response
• divination.py:35-82 (helper)

  Key helper method in BiblioManticDiviner class that generates the I Ching hexagram, formats wisdom, augments the query, and provides metadata. Called by the tool handler.
  def divine_query_augmentation(self, original_query: str) -> Tuple[str, dict]: """ Augment a user query with bibliomantic I Ching wisdom. This method performs the core bibliomantic operation: 1. Generate random hexagram through coin divination 2. Extract wisdom text from the hexagram 3. Integrate this wisdom with the original query 4. Return augmented query with divination metadata Args: original_query: The user's original question or request Returns: Tuple containing: - augmented_query: Original query prefaced with I Ching wisdom - divination_info: Metadata about the divination performed """ try: # Perform I Ching divination hexagram_number, hexagram_name, interpretation = self.iching.generate_hexagram_by_coins() # Create divination metadata for transparency divination_info = { "hexagram_number": hexagram_number, "hexagram_name": hexagram_name, "interpretation": interpretation, "method": "three_coin_traditional", "bibliomantic_approach": "dick_high_castle" } # Format the I Ching wisdom for integration wisdom_text = self.iching.format_divination_text( hexagram_number, hexagram_name, interpretation ) # Augment the original query with bibliomantic wisdom augmented_query = self._integrate_wisdom_with_query(wisdom_text, original_query) logger.info(f"Divination performed: Hexagram {hexagram_number} - {hexagram_name}") return augmented_query, divination_info except Exception as e: logger.error(f"Divination failed: {str(e)}") # Graceful degradation: return original query if divination fails return original_query, {"error": str(e), "fallback": True}
• bibliomantic_fastmcp_ethical.py:99-144 (handler)

  Ethical variant of the bibliomantic_consultation handler with added disclaimers.
  @mcp.tool() def bibliomantic_consultation(query: str) -> str: """ Perform bibliomantic consultation following Philip K. Dick's approach. Augments your query with I Ching wisdom, creating a bridge between your specific question and ancient guidance, as described in "The Man in the High Castle". Args: query: The question or situation requiring guidance Returns: Complete bibliomantic consultation with hexagram wisdom and ethical context """ logger.info(f"Performing bibliomantic consultation with ethical safeguards") if not query.strip(): return f"Please provide a question for bibliomantic consultation.\n\n{BRIEF_DISCLAIMER}" # Perform divination and augment query augmented_query, divination_info = diviner.divine_query_augmentation(query) if "error" in divination_info: error_msg = f"Consultation failed: {divination_info['error']}" logger.error(error_msg) return f"{error_msg}\n\n{BRIEF_DISCLAIMER}" response = f"""🔮 **Bibliomantic Consultation** **Your Question:** {query} **Oracle's Guidance - Hexagram {divination_info['hexagram_number']}: {divination_info['hexagram_name']}** {divination_info['interpretation']} **Bibliomantic Context:** This consultation follows the approach described in Philip K. Dick's "The Man in the High Castle," where characters use the I Ching for reflection on complex decisions. The randomness is generated cryptographically, and any wisdom emerges from your own contemplation of the patterns and meanings. **How to Use This Guidance:** Consider how this ancient perspective might offer new ways of thinking about your situation. The value lies not in prediction, but in the fresh viewpoints that can emerge from engaging with different frameworks of understanding. {ETHICAL_DISCLAIMER}""" logger.info(f"Completed bibliomantic consultation with hexagram {divination_info['hexagram_number']} and ethical context") return response
• enhanced_bibliomantic_server.py:106-160 (handler)

  Enhanced variant of the handler with richer I Ching content and backward compatibility.
  @mcp.tool() def bibliomantic_consultation(query: str) -> str: """ Enhanced bibliomantic consultation with full traditional I Ching elements. DRAMATICALLY IMPROVED CONTENT while maintaining exact interface compatibility. """ logger.info("Performing enhanced bibliomantic consultation") if not query.strip(): return f"Please provide a question for bibliomantic consultation.\n\n{BRIEF_DISCLAIMER}" # Use enhanced consultation if available if ENHANCED_MODE and hasattr(diviner, 'perform_enhanced_consultation'): try: enhanced_result = diviner.perform_enhanced_consultation(query) # Add bibliomantic context and disclaimer enhanced_result += f"\n\n**How to Use This Guidance:**\n" enhanced_result += "Consider how this ancient perspective might offer new ways of thinking about your situation. " enhanced_result += "The value lies not in prediction, but in the fresh viewpoints that can emerge from engaging " enhanced_result += "with different frameworks of understanding.\n\n" enhanced_result += ETHICAL_DISCLAIMER logger.info("Completed enhanced bibliomantic consultation") return enhanced_result except Exception as e: logger.error(f"Enhanced consultation failed, falling back: {str(e)}") # Fallback to original method (backward compatibility) augmented_query, divination_info = diviner.divine_query_augmentation(query) if "error" in divination_info: error_msg = f"Consultation failed: {divination_info['error']}" logger.error(error_msg) return f"{error_msg}\n\n{BRIEF_DISCLAIMER}" response = f"""🔮 **Bibliomantic Consultation** **Your Question:** {query} **Oracle's Guidance - Hexagram {divination_info['hexagram_number']}: {divination_info['hexagram_name']}** {divination_info['interpretation']} **Bibliomantic Context:** This consultation follows the approach described in Philip K. Dick's "The Man in the High Castle," where characters use the I Ching for reflection on complex decisions. The randomness is generated cryptographically, and any wisdom emerges from your own contemplation of the patterns and meanings. **How to Use This Guidance:** Consider how this ancient perspective might offer new ways of thinking about your situation. The value lies not in prediction, but in the fresh viewpoints that can emerge from engaging with different frameworks of understanding. {ETHICAL_DISCLAIMER}""" logger.info(f"Completed bibliomantic consultation with hexagram {divination_info['hexagram_number']}") return response