Tung Shing MCP Server：中国传统黄历服务

项目简介

Tung Shing MCP Server 是一个基于 Model Context Protocol (MCP) 的应用后端，它提供中国传统黄历（通胜）的计算和查询服务。通过此 MCP 服务器，用户可以获取指定日期的每日和时辰的吉凶宜忌、五行、神煞、星宿等详细信息，以便在日常生活中参考。

主要功能点

公历转农历： 支持将公历日期转换为农历日期。
每日黄历信息： 提供每日的吉凶、宜忌、五行、冲煞、值神、建除十二神、二十八星宿、吉神凶煞、彭祖百忌等详细信息。
时辰黄历信息： 提供每日十二时辰的吉凶、宜忌、星神、五行、冲煞、方位等详细信息。
可定制日期查询： 允许用户指定开始日期和查询天数，批量获取黄历信息。

安装步骤

NPX 方式 (无需全局安装):

确保您的环境中已安装 Node.js 和 npm。
在您的 MCP 客户端配置中，可以直接使用 NPX 运行此 MCP 服务器。

CLI 方式 (全局安装):

确保您的环境中已安装 Node.js 和 npm。

打开终端，运行以下命令全局安装 'mcp-tung-shing' 包：

npm install -g mcp-tung-shing

服务器配置

要将 Tung Shing MCP Server 添加到您的 MCP 客户端配置中，您需要指定服务器的启动命令。以下是两种安装方式对应的配置方法：

NPX 方式配置：

{
  "mcpServers": {
    "tung-shing": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-tung-shing"
      ]
    }
  }
}

'command': 指定启动服务器的命令为 'npx'，用于执行 Node.js 包。
'args': 传递给 'npx' 的参数，'-y' 表示自动确认安装包（如果需要），'mcp-tung-shing' 是要执行的包名，即 Tung Shing MCP Server。

CLI 方式配置：

{
  "mcpServers": {
    "tung-shing": {
      "command": "mcp-tung-shing"
    }
  }
}

'command': 指定启动服务器的命令为 'mcp-tung-shing'，这是全局安装后可直接执行的命令。
'args': 在此配置中，'args' 字段为空，因为 'mcp-tung-shing' 命令本身已包含了所有必要信息。

基本使用方法

配置完成后，您的 MCP 客户端可以通过调用 'get-tung-shing' 工具来获取黄历信息。

调用 'get-tung-shing' 工具：

参数：
- 'startDate' (可选): 开始日期，格式为 "YYYY-MM-DD"。默认为当天日期。
- 'days' (可选): 获取黄历的天数，默认为 1 天。

示例请求 (JSON-RPC CallToolRequest):

{
  "jsonrpc": "2.0",
  "method": "CallTool",
  "params": {
    "name": "get-tung-shing",
    "arguments": {
      "startDate": "2024-07-20",
      "days": 3
    }
  },
  "id": " TungShingExample"
}

上述请求将获取从 2024-07-20 开始，连续 3 天的黄历信息。如果不提供参数，则默认获取当天的黄历信息。

响应：

服务器会返回包含每日黄历信息的 JSON-RPC 响应，内容以 Markdown 格式的文本数组形式提供。每个文本条目对应一天的黄历信息，包含日期、农历日期、宜忌、详细信息和时辰信息等。

关键词