Bibliomantic MCP Server

高层摘要（一句话）：

提供一个 Model-Context-Protocol 服务器，你的 AI 聊天工具可在任何需要从《易经》中随机选取一段中国智慧以完成其给定任务时调用它。

Related MCP server: taibu

原始简短摘要

一个将《易经》占卜与 AI 回复集成的 Model Context Protocol 服务器，探索了 Philip K. Dick 的 高堡奇人 中所描述的书籍占卜法。

目的

该服务器展示了如何通过 MCP 将传统智慧体系与现代 AI 进行审慎地集成。它提供：

• 教育探索：对中国古代哲学和《易经》的探索

• 文学背景：来自 Philip K. Dick 的影响深远的科幻作品

• 哲学反思工具：用于创造性思维和换位思考

• 技术展示：展示 FastMCP 在工具、资源和提示词方面的能力

功能

• 传统《易经》系统：全部 64 个卦象，模拟正统的三枚硬币占卜法

• 书籍占卜咨询：遵循 Philip K. Dick 在《高堡奇人》中采用的方法

• FastMCP 实现：专业的 MCP 合规性，支持工具、资源和提示词

• 伦理保障：明确声明其仅供娱乐/反思之用

• 教育背景：每次咨询都附带历史与哲学背景

• 资源访问：直接访问卦象数据库以加载 AI 上下文

先决条件

• Python 3.10+（MCP SDK 所需）

• MCP 兼容主机（Claude Desktop 等）

安装

从源码安装

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

备选配置：

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

可用工具

• i_ching_divination - 生成带有传统解读的随机卦象

• bibliomantic_consultation - 完整的书籍占卜流程，并带有查询增强

• get_hexagram_details - 按编号（1-64）查找特定卦象

• server_statistics - 查看系统信息和能力

资源

• hexagram://{number} - 加载单个卦象数据以供 AI 上下文使用

• iching://database - 访问完整 64 卦象数据库概览

提示模板

• career_guidance_prompt - 用于职业决策的结构化提示

• creative_guidance_prompt - 用于艺术和创意项目的提示

• general_guidance_prompt - 通用的生活指导模板

使用示例

基本占卜

向 Claude 提问：

"你能为我的创意项目进行一次《易经》占卜，以获得哲学指引吗？"

书籍占卜咨询

"我正面临关于职业道路的艰难决定。你能用书籍占卜法咨询《易经》吗？"

资源访问

"加载 hexagram://1 资源以理解乾卦。"

特定卦象查询

"你能告诉我《易经》第 42 卦吗？"

书籍占卜法

该实现遵循 Philip K. Dick 的 高堡奇人 中描述的占卜方法，书中人物通过咨询《易经》来获得重要决策的指导。该系统：

• 使用传统的《易经》方法，通过投掷三枚硬币进行占卜

• 生成密码学上安全的随机数，以确保占卜的真实性

• 将古老智慧与现代 AI 能力相结合

• 保持书籍占卜的哲学与反思特性

• 在占卜过程中提供透明度

伦理框架

所有回复都包含明确的免责声明，说明这仅用于哲学反思和娱乐，并非超自然指引或生活建议。对于重要决策，用户应咨询合格的专业人士。

该服务器强调：

• 对智慧传统的教育性探索

• 创造性思维和换位思考

• 哲学反思而非预测

• 尊重古代传统与现代伦理标准

开发

使用 MCP Inspector 进行测试

mcp dev bibliomantic_server.py

本地运行

python bibliomantic_server.py

技术实现

基于以下技术构建：

• FastMCP - 官方 MCP Python SDK，确保专业合规性

• 传统《易经》 - 包含完整 64 卦数据库和真实的解读

• 密码学随机性 - 使用 Python 的 secrets 模块进行安全的三枚硬币模拟

• 类型安全 - 完整的类型提示，自动生成 JSON schema

• 伦理保障 - 所有回复中都有面向用户的免责声明

使用场景

• 教育工具：用于学习《易经》哲学和中国智慧传统

• 创意写作辅助：用于生成新视角和灵感

• 哲学反思工具：用于思考人生决策和变化

• 文化桥梁：连接古老智慧与现代 AI 能力

• 技术演示：展示带有文化内容的 MCP 服务器开发

• 文学分析：分析 Philip K. Dick 的主题和书籍占卜概念

安全注意事项

• 对所有用户查询和参数进行输入验证

• 没有外部网络请求或 API 依赖

• 生成密码学上安全的随机数

• 清晰的伦理边界和用户教育

• 不持久化存储数据或跟踪用户

贡献

欢迎贡献！请：

1. 遵循现有的代码风格和模式

2. 使用 MCP Inspector 为新功能添加测试

3. 更新任何更改的文档

4. 确保与官方 MCP SDK 的兼容性

5. 保持伦理框架和教育重点

许可证

MIT 许可证 - 详见 LICENSE 文件。

致谢

• Philip K. Dick：感谢其提供的文学灵感和书籍占卜方法

• 中国古代哲学家：感谢其贡献的《易经》智慧传统

• Anthropic：感谢其提供的 Model Context Protocol 和 FastMCP 框架

• MCP 社区：感谢其对创新 AI 集成的推动

"神谕是对的。未来仍在前方。" - Philip K. Dick，《高堡奇人》