JinDaGe - bibliomantic-mcp-server MCP Details

article

README

🚀 易经占卜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依赖。
加密安全的随机数生成。
明确的道德界限和用户教育。
无持久数据存储或用户跟踪。

贡献

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

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

致谢

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

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

bibliomantic-mcp-server