Bibliomantic MCP Server

🚀 易经占卜MCP服务器

这是一个模型上下文协议（MCP）服务器，它将易经占卜与人工智能响应相结合，探索菲利普·K·迪克（Philip K. Dick）在《高堡奇人》（The Man in the High Castle）中描述的占卜方法。该服务器通过MCP展示了如何将传统智慧系统与现代人工智能进行巧妙融合，为用户提供了多方面的价值。

🚀 快速开始

本服务器借助MCP展示了如何将传统智慧系统与现代人工智能进行巧妙融合。它提供了以下内容：

• 对中国古代哲学和《易经》的教育性探索。
• 菲利普·K·迪克有影响力的科幻作品中的文学背景。
• 用于创造性思维和换位思考的哲学反思工具。
• 借助工具、资源和提示展示FastMCP能力的技术演示。

✨ 主要特性

• 传统易经系统：具备全部64卦，采用正宗的三枚硬币法模拟。
• 占卜咨询：遵循菲利普·K·迪克在《高堡奇人》中的方法。
• FastMCP实现：专业符合MCP标准，配备工具、资源和提示。
• 道德保障：明确声明仅用于娱乐和反思目的。
• 教育背景：每次咨询都提供历史和哲学背景信息。
• 资源访问：可直接访问卦象数据库，用于加载人工智能上下文。

📦 安装指南

前提条件

• Python 3.10+（MCP SDK要求）
• 兼容MCP的主机（如Claude Desktop等）

使用uvx（推荐）

uvx bibliomantic-mcp-server

使用pip

pip install bibliomantic-mcp-server

从源代码安装

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

📚 详细文档

Claude Desktop配置

在claude_desktop_config.json中添加以下内容：

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

替代配置：

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

可用工具

• i_ching_divination - 生成带有传统解释的随机卦象。
• bibliomantic_consultation - 完整的占卜过程，包括查询增强。
• get_hexagram_details - 按编号（1 - 64）查找特定卦象。
• server_statistics - 查看系统信息和功能。

资源

• hexagram://{number} - 加载单个卦象数据以用于人工智能上下文。
• iching://database - 访问完整的64卦数据库概述。

提示模板

• career_guidance_prompt - 用于职业决策的结构化提示。
• creative_guidance_prompt - 用于艺术和创意项目的提示。
• general_guidance_prompt - 通用的生活指导模板。

💻 使用示例

基础用法

询问Claude：

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

高级用法

占卜咨询

“我在职业道路上面临一个艰难的决定。你能使用占卜方法咨询《易经》吗？”

资源访问

“加载hexagram://1资源以了解《乾卦》。”

特定卦象查询

“你能告诉我《易经》第42卦的信息吗？”

🔧 技术细节

占卜方法

本实现遵循菲利普·K·迪克在《高堡奇人》中描述的占卜方法，书中角色咨询《易经》以获得重要决策的指导。该系统：

• 使用传统的《易经》三枚硬币抛掷方法。
• 生成加密安全的随机数，以实现真实的占卜。
• 将古代智慧与现代人工智能能力相结合。
• 保持占卜的哲学和反思性。
• 在占卜过程中提供透明度。

技术实现

该服务器基于以下技术构建：

• FastMCP - 官方MCP Python SDK，确保专业合规。
• 传统《易经》 - 完整的64卦数据库，带有正宗解释。
• 加密随机数 - 使用Python的secrets模块进行安全的三枚硬币模拟。
• 类型安全 - 完整的类型提示，自动生成JSON模式。
• 道德保障 - 所有响应中都包含面向用户的免责声明。

📄 许可证

本项目采用MIT许可证，详情请参阅LICENSE文件。

其他说明

用例

• 教育工具：用于学习《易经》哲学和中国智慧传统。
• 创意写作辅助：用于产生新的视角和灵感。
• 哲学反思工具：用于思考人生决策和变化。
• 文化桥梁：连接古代智慧与现代人工智能能力。
• 技术演示：展示带有文化内容的MCP服务器开发。
• 文学分析：分析菲利普·K·迪克的主题和占卜概念。

安全考虑

• 对所有用户查询和参数进行输入验证。
• 无外部网络请求或API依赖。
• 加密安全的随机数生成。
• 明确的道德界限和用户教育。
• 无持久数据存储或用户跟踪。

贡献

欢迎贡献代码！请遵循以下步骤：

1. 遵循现有的代码风格和模式。
2. 使用MCP Inspector为新功能添加测试。
3. 为任何更改更新文档。
4. 确保与官方MCP SDK兼容。
5. 维护道德框架和教育重点。

致谢

• 菲利普·K·迪克：提供文学灵感和占卜方法。
• 中国古代哲学家：传承《易经》智慧传统。
• Anthropic：提供模型上下文协议和FastMCP框架。
• MCP社区：推动创新的人工智能集成。

“神谕是正确的。未来仍在前方。” - 菲利普·K·迪克，《高堡奇人》