项目简介

八字MCP是参天AI开发的一个遵循Model Context Protocol (MCP) 的服务器实现，旨在为AI智能体（如大型语言模型客户端）提供可靠、准确的八字（四柱命理）计算能力。它通过标准化的协议接口，使得AI能够调用专业的八字排盘功能，避免了AI自身进行复杂计算可能产生的错误，从而增强AI在相关领域的专业性和可信度。

主要功能点

• 精确八字排盘： 根据用户提供的阳历或农历时间，准确计算出包括年柱、月柱、日柱、时柱在内的完整八字信息。
• 详细命理数据： 排盘结果包含干支、五行、阴阳、十神、藏干、纳音、空亡、星运、自坐、胎元、胎息、命宫、身宫等详细信息。
• 丰富神煞列表： 计算并列出四柱中包含的各类神煞，为命理分析提供参考。
• 支持多种日期输入： 提供分别根据农历日期时间 ('buildBaziFromLunarDatetime' 工具) 和阳历日期时间 ('buildBaziFromSolarDatetime' 工具) 进行计算的功能。

安装步骤

1. 前置需求： 确保你的系统中已安装 Node.js 22 版本或以上。
2. 克隆仓库： 将项目的代码仓库克隆到本地计算机。
3. 安装依赖： 打开终端或命令提示符，进入项目所在的目录，运行以下命令安装项目所需的依赖库：

   npm i
   

服务器配置

八字MCP作为一个MCP服务器，是供支持MCP协议的AI客户端使用的。AI客户端需要配置如何启动并连接到此服务器。典型的配置方式是指定服务器的名称、启动服务器的命令及其参数。

• 服务器名称： 可以自定义，例如 'Bazi'。
• 启动命令 ('command')： 指定用于启动Node.js程序的命令，通常是 'node'。
• 启动参数 ('args')： 提供传递给Node.js命令的参数，其中最关键的是项目的入口文件路径。对于本MCP服务器，应指向编译后的Stdio传输入口文件，例如 '/path/to/your/bazi-mcp/dist/stdio.js'（请将 '/path/to/your/bazi-mcp/' 替换为你实际克隆项目的绝对路径）。

配置示例（由MCP客户端进行）：MCP客户端会在其设置中，通常在'mcpServers'部分，添加一个配置项。例如：

• 配置项名称：'Bazi'
• 'command': 'node'
• 'args': '["/你的项目绝对路径/dist/stdio.js"]'

配置完成后，兼容的AI客户端在需要调用八字功能时，会根据此配置自动启动并连接到八字MCP服务器。

基本使用方法

作为用户，你通常无需直接与此MCP服务器交互。你需要使用一个支持MCP协议的AI客户端（如某些定制的AI助手或平台），并在该客户端中完成以下操作：

1. 配置MCP服务器： 按照上一步骤，在AI客户端的设置中配置好八字MCP服务器的启动信息。
2. 通过AI客户端发起请求： 当你在AI客户端中输入与八字相关的请求时（例如：“请为我计算公历 2000年5月15日 12:00出生的女性的八字”），AI客户端会识别出需要调用外部工具来获取信息。
3. AI客户端调用MCP工具： AI客户端会自动根据你的请求，调用八字MCP服务器暴露的相应工具（如 'buildBaziFromSolarDatetime'），并将必要的参数（出生日期、性别等）传递给服务器。
4. 获取并利用结果： 八字MCP服务器执行计算并将结果返回给AI客户端。AI客户端接收到结构化的八字数据后，可以将其展示给你，或者进一步利用这些数据进行更深入的分析或对话生成。

简而言之，你只需安装并配置好本MCP服务器，然后在支持MCP协议的AI客户端中像平常一样提问，AI客户端会智能地调用本服务器为你提供准确的八字信息。