Bibliomantic

A Model Context Protocol server that integrates I Ching divination with AI responses, exploring the bibliomantic approach described in Philip K. Dick’s The Man in the High Castle.

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run a Python-based Model Context Protocol (MCP) server that combines I Ching divination with bibliomancy-inspired AI guidance. This server demonstrates secure, educational, and creative interactions by loading a complete 64-hexagram I Ching database, performing cryptographically secure three-coin toss divination, and guiding the AI through bibliomantic prompts. It is designed for learning how MCP servers operate, how to run a local server, and how to connect clients to receive structured, reflective insights.

How to use

Launch the server locally and connect with an MCP client to perform I Ching divination and bibliomantic consultations. You’ll be able to generate hexagrams, load hexagram details, run full bibliomantic sessions augmented with prompts, and view system statistics. Use this server to explore how traditional wisdom systems can inform creative thinking and philosophical reflection in tandem with AI capabilities.

How to install

Prerequisites you need before installing: Python 3.10 or newer and a compatible MCP host environment.

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

Additional configuration and usage notes

You can run the server locally using the standard Python entry point. The project provides a ready-to-run MCP configuration example that you can adapt to your environment.

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

Security and ethics notes

The server includes explicit disclaimers that its guidance is for philosophical reflection and entertainment only. It does not provide life advice or professional recommendations. Ensure input validation, no external data dependencies, and no data persistence to protect user privacy.

Development and testing

To test with MCP Inspector and verify behavior during development, run the following:

mcp dev bibliomantic_server.py

Run locally

Start the server directly from the project directory once dependencies are installed.

python bibliomantic_server.py

Tools and capabilities overview

The server exposes a set of tools to support different workflows, including I Ching divination, full bibliomantic consultations, hexagram lookups, and system statistics.

Notes on usage patterns

Use cryptographically secure randomness for divination to ensure authentic three-coin toss results.
Load hexagram data as needed to provide AI context for interpretations.
Combine educational context with reflective prompts to support creative thinking and philosophical exploration.

Available tools

i_ching_divination

Generate random hexagrams using a traditional three-coin method with authentic interpretations and cryptographically secure randomness.

bibliomantic_consultation

Execute a full bibliomantic process that augments user queries with context loading from the hexagram database and prompts for reflective AI guidance.

get_hexagram_details

Look up specific hexagrams by number (1-64) to retrieve detailed meanings, lines, and historical context.

server_statistics

Provide system information and capabilities to help you monitor server health and features.