关键词

四柱推命命式运势八字算命命理

项目简介

Meishiki 是一个用于计算四柱推命（也称为八字）命式和运势的 Python 库。本项目在此基础上，通过实现 Model Context Protocol (MCP) 协议，将核心计算能力封装为一个 MCP 服务器，使支持 MCP 协议的 LLM 客户端（如 ClaudeDesktop）能够方便地调用此功能，获取详细的命理分析结果。

主要功能点

  • 四柱推命计算: 根据输入的出生日期（包含时分）和性别，精确计算个人的年、月、日、时四柱的干支、藏干、通变星、十二运等。
  • 运势分析: 计算大运和流年运势，包括干支、通变星及其与命局的相互作用（如干合、支合、冲、刑、害等）。
  • 结果输出: 提供结构化的计算结果，包括五行平衡、阴阳比例、月令、空亡、特记（阳刃、魁罡）等详细信息。

本项目作为 MCP 服务器，其核心功能是响应 LLM 客户端的请求，执行“计算命式”的工具功能，并将计算结果返回给客户端。

安装步骤

  1. 确保环境: 需要 Python 3.7 或更高版本。

  2. 安装库: 使用 pip 安装 meishiki 库及其 MCP 服务器实现所需的依赖（fastmcp）。

    pip install meishiki fastmcp

服务器配置

MCP 服务器通常不会直接运行，而是由支持 MCP 的 LLM 客户端（如 ClaudeDesktop）根据配置文件启动和管理。以下是配置该 MCP 服务器的示例信息（请根据您的客户端和实际安装路径调整）：

{
  "mcpServers": {
    "meishiki": {
      "name": "Meishiki Server", // 服务器在客户端中显示的名称
      "command": "{local repository}/meishiki/.venv/bin/python3", // 用于启动服务器的可执行文件路径
      "args": ["-u", "{local repository}/meishiki/mcp_server.py"], // 传递给启动命令的参数，-u 通常用于无缓冲输出
      "transport": "stdio" // 使用标准输入/输出流进行通信
    }
    // 您可能还有其他MCP服务器的配置...
  }
}

请将 '{local repository}/meishiki' 替换为您实际克隆或安装 'meishiki' 库的路径。具体的配置位置和格式请查阅您的 LLM 客户端（例如 ClaudeDesktop）的文档。

基本使用方法

该 MCP 服务器是作为后端服务运行的，不提供直接的用户界面。您需要使用一个支持 MCP 协议的 LLM 客户端来与其交互：

  1. 启动客户端: 启动您的 LLM 客户端（例如 ClaudeDesktop）。客户端会读取配置并根据需要启动 Meishiki MCP 服务器。
  2. 调用工具: 在 LLM 客户端中，您可以通过相应的指令或界面元素来调用 Meishiki MCP 服务器提供的计算工具。
  3. 提供输入: 客户端会提示您输入进行四柱推命计算所需的参数，通常是出生日期（精确到时分）和性别。请按照工具的说明提供正确的格式输入（例如，ISO8601 格式的日期时间字符串 "YYYY-MM-DDTHH:MM:SS" 和代表性别的数字或枚举值）。
  4. 获取结果: 服务器执行计算并将结果返回给客户端。客户端通常会将这些结果展示给您，或将其用作 LLM 生成回复的上下文信息。

例如，一个支持工具调用的客户端可能会通过对话或界面让您填写生日和性别，然后调用服务器上的 'calculate_meishiki' 工具来获取四柱命理结果。

信息

分类

AI与计算

访问项目