项目简介
Bibliomantic 周易卜卦 MCP 服务器旨在为AI客户端提供一套《易经》卜卦服务。它不仅能进行传统的周易卜卦,还能根据用户的提问,以菲利普·K·迪克在小说《高堡奇人》中描述的图书卜卦方式,将卜卦结果与用户问题结合,提供哲学性的指导。服务器还提供了丰富的《易经》卦象详情和数据库资源,支持AI模型获取深度上下文信息。所有卜卦结果都附带明确的免责声明,强调其仅用于哲学反思和娱乐。
主要功能点
- 传统周易卜卦: 模拟三枚硬币投掷方法,生成《易经》64卦之一,并提供详细的卦象解读,包括卦辞、象辞、爻辞及不同语境下的解释。
- 图书卜卦咨询: 遵循菲利普·K·迪克《高堡奇人》中的方法,将卜卦结果巧妙地融入用户的原始问题中,引导AI提供富有洞见的回复。此功能提供更丰富的卦象内容,包括中文名、符号和卦象组成分析。
- 卦象详情查询: 允许用户查询《易经》中任一卦象(1-64)的详细信息,包括中文名、Unicode符号、上下卦构成、卦辞、象辞、卦象总义及传统评论等。
- 服务器状态统计: 提供服务器运行状态、《易经》数据库信息和卜卦系统能力概览。
- 上下文资源访问: 提供完整的《易经》数据库和单个卦象的数据资源,方便AI模型直接加载和利用上下文。
- 自定义提示模板: 包含职业指导、创意项目指导和通用人生指导的预设提示模板,帮助AI构建更具结构化的互动。
安装步骤
- 克隆仓库:
git clone https://github.com/d4nshields/bibliomantic-mcp-server.git cd bibliomantic-mcp-server - 安装依赖:
这将安装所有必需的Python依赖,包括'FastMCP' SDK。pip install -e .
服务器配置 (供MCP客户端使用)
MCP客户端(如Claude Desktop)需要以下JSON配置信息来连接并使用此服务器。请将以下配置添加到您的MCP客户端配置中:
{ "mcpServers": { "bibliomantic": { "command": "python", "args": ["-m", "bibliomantic_server"], "description": "一个提供《易经》卜卦和图书卜卦体验的MCP服务器。遵循《高堡奇人》的图书卜卦方式,并提供丰富的《易经》上下文。" } } }
- 'bibliomantic': 这是MCP客户端中用于识别此服务器的名称,可以自定义。
- 'command': 启动服务器所需的命令,这里是'python'解释器。
- 'args': 传递给'command'的参数。'-m bibliomantic_server'表示以Python模块形式运行仓库中的'bibliomantic_server.py'文件。
- 'description': 服务器的简要说明,帮助用户理解其功能和用途。
基本使用方法
配置好MCP客户端并启动服务器后,您可以像与普通AI工具一样与服务器互动:
- 进行基本卜卦: 询问AI,例如:"你能为我的创意项目提供一些哲学指导,进行一次周易卜卦吗?" AI会调用'i_ching_divination'工具。
- 进行图书卜卦咨询: 询问AI,例如:"我正在面临一个艰难的职业选择,你能用图书卜卦的方法咨询一下《易经》吗?" AI会调用'bibliomantic_consultation'工具。
- 查询特定卦象详情: 询问AI,例如:"能告诉我《易经》第42卦的信息吗?" AI会调用'get_hexagram_details'工具。
- 获取服务器统计信息: 询问AI,例如:"你能告诉我服务器的运行状态和功能吗?" AI会调用'server_statistics'工具。
- 加载卦象资源: AI客户端可以直接请求加载资源,例如:'Load the hexagram://1 resource to understand The Creative.' 或 'Load the iching://database resource.'
- 使用提示模板: AI可以调用预设的提示模板来构造特定领域的咨询,例如在职业指导方面,通过调用'career_guidance_prompt'。
信息
分类
AI与计算