🚀 易经占卜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·迪克，《高堡奇人》