Bibliomantic MCP Server

🚀 Bibliomantic MCP Server

A Model Context Protocol server integrating I Ching divination with AI responses, exploring the bibliomantic approach from Philip K. Dick's The Man in the High Castle.

🚀 Quick Start

This server showcases how traditional wisdom systems can be effectively integrated with modern AI via MCP. It offers educational exploration of ancient Chinese philosophy and the I Ching, literary context from Philip K. Dick's science - fiction, philosophical reflection tools, and a technical demonstration of FastMCP capabilities.

✨ Features

• Traditional I Ching System: Simulates the authentic three - coin method for all 64 hexagrams.
• Bibliomantic Consultation: Adheres to Philip K. Dick's approach in The Man in the High Castle.
• FastMCP Implementation: Complies professionally with MCP, equipped with tools, resources, and prompts.
• Ethical Safeguards: Includes clear disclaimers for entertainment and reflection purposes.
• Educational Context: Provides historical and philosophical background for each consultation.
• Resource Access: Enables direct access to the hexagram database for AI context loading.

📦 Installation

Using uvx (recommended)

uvx bibliomantic-mcp-server

Using pip

pip install bibliomantic-mcp-server

From source

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

📚 Documentation

Claude Desktop Configuration

Add the following to your claude_desktop_config.json:

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

Alternative configurations:

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

Available Tools

• i_ching_divination: Generates random hexagrams with traditional interpretations.
• bibliomantic_consultation: Conducts the full bibliomantic process with query augmentation.
• get_hexagram_details: Looks up specific hexagrams by number (1 - 64).
• server_statistics: Views system information and capabilities.

Resources

• hexagram://{number}: Loads individual hexagram data for AI context.
• iching://database: Accesses the complete 64 - hexagram database overview.

Prompt Templates

• career_guidance_prompt: Structured prompts for career decisions.
• creative_guidance_prompt: Prompts for artistic and creative projects.
• general_guidance_prompt: Universal life guidance templates.

💻 Usage Examples

Basic Usage

Ask Claude:

"Can you perform an I Ching divination for philosophical guidance on my creative projects?"

Advanced Usage

# Ask for bibliomantic consultation
print("I'm facing a difficult decision about my career path. Can you consult the I Ching using the bibliomantic approach?")

# Access resources
print("Load the hexagram://1 resource to understand The Creative.")

# Look up specific hexagrams
print("Can you tell me about I Ching hexagram number 42?")

🔧 Technical Details

The Bibliomantic Approach

This implementation follows the divination method in Philip K. Dick's The Man in the High Castle. It uses traditional I Ching methodology, generates cryptographically secure randomness, integrates ancient wisdom with modern AI, maintains philosophical reflection, and provides transparency in the divination process.

Ethical Framework

All responses include clear disclaimers that this is for philosophical reflection and entertainment only. The server emphasizes educational exploration, creative thinking, philosophical reflection, and respect for both ancient traditions and modern ethical standards.

Development

Testing with MCP Inspector

mcp dev bibliomantic_server.py

Running locally

python bibliomantic_server.py

Technical Implementation

The server is built with:

• FastMCP: The official MCP Python SDK for professional compliance.
• Traditional I Ching: A complete 64 - hexagram database with authentic interpretations.
• Cryptographic randomness: Secure three - coin simulation using Python's secrets module.
• Type safety: Full type hints with automatic JSON schema generation.
• Ethical safeguards: User - facing disclaimers in all responses.

📄 License

This project is under the MIT License. See the LICENSE file for details.

🤝 Acknowledgments

• Philip K. Dick: For literary inspiration and the bibliomantic approach.
• Ancient Chinese philosophers: For the I Ching wisdom tradition.
• Anthropic: For the Model Context Protocol and FastMCP framework.
• The MCP community: For fostering innovative AI integrations.

📋 Use Cases

• Educational tool: For learning about I Ching philosophy and Chinese wisdom traditions.
• Creative writing aid: For generating new perspectives and inspiration.
• Philosophical reflection tool: For contemplating life decisions and changes.
• Cultural bridge: Between ancient wisdom and modern AI capabilities.
• Technical demonstration: Of MCP server development with cultural content.
• Literary analysis: Of Philip K. Dick's themes and bibliomantic concepts.

🔒 Security Considerations

• Validates all user queries and parameters.
• Has no external network requests or API dependencies.
• Generates cryptographically secure randomness.
• Sets clear ethical boundaries and educates users.
• Does not store persistent data or track users.

🤝 Contributing

Contributions are welcome! Please:

1. Follow the existing code style and patterns.
2. Add tests for new functionality using MCP Inspector.
3. Update documentation for any changes.
4. Ensure compatibility with the official MCP SDK.
5. Maintain the ethical framework and educational focus.