Bibliomantic MCP Server

Resumen de alto nivel en una línea:

Proporciona un servidor Model-Context-Protocol al que tu chat de IA puede llamar en cualquier momento que necesite un fragmento elegido al azar de sabiduría china seleccionado del I Ching para completar la tarea que se le ha asignado.

Related MCP server: taibu

Resumen conciso original

Un servidor Model Context Protocol que integra la adivinación del I Ching con respuestas de IA, explorando el enfoque bibliomántico descrito en El hombre en el castillo de Philip K. Dick.

Propósito

Este servidor demuestra cómo los sistemas de sabiduría tradicional pueden integrarse cuidadosamente con la IA moderna a través de MCP. Proporciona:

• Exploración educativa de la filosofía china antigua y el I Ching

• Contexto literario de la influyente obra de ciencia ficción de Philip K. Dick

• Herramientas de reflexión filosófica para el pensamiento creativo y la toma de perspectiva

• Demostración técnica de las capacidades de FastMCP con herramientas, recursos y prompts

Características

• Sistema tradicional del I Ching: Los 64 hexagramas con simulación auténtica del método de las tres monedas

• Consulta bibliomántica: Siguiendo el enfoque de Philip K. Dick de "El hombre en el castillo"

• Implementación FastMCP: Cumplimiento profesional de MCP con herramientas, recursos y prompts

• Salvaguardas éticas: Avisos claros sobre el propósito de entretenimiento/reflexión

• Contexto educativo: Antecedentes históricos y filosóficos para cada consulta

• Acceso a recursos: Acceso directo a la base de datos de hexagramas para la carga de contexto de IA

Requisitos previos

• Python 3.10+ (requerido por el SDK de MCP)

• Host compatible con MCP (Claude Desktop, etc.)

Instalación

Desde el código fuente

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

Configuraciones alternativas:

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

Herramientas disponibles

• i_ching_divination - Genera hexagramas aleatorios con interpretaciones tradicionales

• bibliomantic_consultation - Proceso bibliomántico completo con aumento de consulta

• get_hexagram_details - Consulta hexagramas específicos por número (1-64)

• server_statistics - Ver información del sistema y capacidades

Recursos

• hexagram://{number} - Cargar datos de un hexagrama individual para el contexto de IA

• iching://database - Acceder a la vista general completa de la base de datos de los 64 hexagramas

Plantillas de prompts

• career_guidance_prompt - Prompts estructurados para decisiones profesionales

• creative_guidance_prompt - Prompts para proyectos artísticos y creativos

• general_guidance_prompt - Plantillas universales de orientación para la vida

Ejemplos de uso

Adivinación básica

Pregúntale a Claude:

"¿Puedes realizar una adivinación del I Ching para obtener orientación filosófica sobre mis proyectos creativos?"

Consulta bibliomántica

"Me enfrento a una decisión difícil sobre mi carrera profesional. ¿Puedes consultar el I Ching utilizando el enfoque bibliomántico?"

Acceso a recursos

"Carga el recurso hexagram://1 para entender Lo Creativo."

Consulta de un hexagrama específico

"¿Puedes contarme sobre el hexagrama número 42 del I Ching?"

El enfoque bibliomántico

Esta implementación sigue el método de adivinación descrito en El hombre en el castillo de Philip K. Dick, donde los personajes consultan el I Ching para orientarse en decisiones importantes. El sistema:

• Utiliza la metodología tradicional del I Ching con lanzamientos de tres monedas

• Genera aleatoriedad criptográficamente segura para una adivinación auténtica

• Integra la sabiduría antigua con las capacidades de la IA moderna

• Mantiene los aspectos filosóficos y reflexivos de la bibliomancia

• Proporciona transparencia en el proceso de adivinación

Marco ético

Todas las respuestas incluyen avisos claros de que esto es solo para reflexión filosófica y entretenimiento, no para orientación sobrenatural ni consejos de vida. Se dirige a los usuarios a consultar profesionales cualificados para decisiones importantes.

El servidor enfatiza:

• Exploración educativa de las tradiciones de sabiduría

• Pensamiento creativo y toma de perspectiva

• Reflexión filosófica en lugar de predicción

• Respeto tanto por las tradiciones antiguas como por los estándares éticos modernos

Desarrollo

Pruebas con MCP Inspector

mcp dev bibliomantic_server.py

Ejecución local

python bibliomantic_server.py

Implementación técnica

Desarrollado con:

• FastMCP - SDK oficial de MCP para Python para un cumplimiento profesional

• I Ching tradicional - Base de datos completa de 64 hexagramas con interpretaciones auténticas

• Aleatoriedad criptográfica - Simulación segura de tres monedas mediante el módulo secrets de Python

• Seguridad de tipos - Anotaciones de tipo completas con generación automática de esquemas JSON

• Salvaguardas éticas - Avisos visibles para el usuario en todas las respuestas

Casos de uso

• Herramienta educativa para aprender sobre la filosofía del I Ching y las tradiciones de sabiduría china

• Ayuda para la escritura creativa para generar nuevas perspectivas e inspiración

• Herramienta de reflexión filosófica para contemplar decisiones y cambios en la vida

• Puente cultural entre la sabiduría antigua y las capacidades de la IA moderna

• Demostración técnica del desarrollo de servidores MCP con contenido cultural

• Análisis literario de los temas de Philip K. Dick y los conceptos bibliománticos

Consideraciones de seguridad

• Validación de entradas para todas las consultas y parámetros del usuario

• Sin solicitudes de red externas ni dependencias de API

• Generación de aleatoriedad criptográficamente segura

• Límites éticos claros y educación del usuario

• Sin almacenamiento persistente de datos ni seguimiento de usuarios

Contribuciones

¡Las contribuciones son bienvenidas! Por favor:

1. Sigue el estilo y los patrones de código existentes

2. Añade pruebas para la nueva funcionalidad usando MCP Inspector

3. Actualiza la documentación para cualquier cambio

4. Asegura la compatibilidad con el SDK oficial de MCP

5. Mantén el marco ético y el enfoque educativo

Licencia

Licencia MIT - consulta el archivo LICENSE para más detalles.

Agradecimientos

• Philip K. Dick por la inspiración literaria y el enfoque bibliomántico

• Filósofos chinos antiguos por la tradición de sabiduría del I Ching

• Anthropic por el Model Context Protocol y el framework FastMCP

• La comunidad MCP por fomentar integraciones innovadoras de IA

"El oráculo tenía razón. El futuro sigue por delante." - Philip K. Dick, El hombre en el castillo