返回 MCP 目录
public公开dns本地运行

lunar-calendar-mcp

一个提供农历日期查询和凶吉宜忌功能的MCP服务器,支持通过命令获取农历信息和当日宜忌事项。

article

README

🚀 🌙 农历日历 MCP 服务器

本项目是一个 MCP 服务器,可提供农历日期和凶吉查询功能,为用户带来便捷的农历信息服务。

🚀 快速开始

此服务器能够提供农历日期和凶吉查询服务,通过特定的接口即可获取相关信息。

✨ 主要特性

  • 📅 get_lunar - 获取指定日期的农历信息
  • 🔮 get_taboo - 查询当日宜忌事项

📦 安装指南

接入配置如下:

{
  "mcpServers": {
    "lunar": {
      "command": "tnpx",
      "args": [
        "-y",
        "lunar-calendar-mcp"
      ]
    }
  }
}

🔧 技术细节

本项目采用的技术栈如下: | 属性 | 详情 | |------|------| | 模型类型 | Model Context Protocol (MCP) | | 训练数据 | 无 |

  • Node.js
  • TypeScript
  • Model Context Protocol (MCP)

📄 许可证

本项目采用 MIT License 开源协议。

🤝 贡献指南

欢迎提交 Issue 和 PR!

如何调试

安装 mcp 工具

可参考:https://github.com/f/mcptools

brew tap f/mcptools
brew install mcp

构建

npm run build

列出工具

mcp tools node dist/index.js

返回:

get_lunar([date:str])
     获取当天的农历日期

get_taboo([date:str])
     获取当天的凶吉

调用工具

mcp call get_lunar --params '{"date":"2025-04-10"}'  node dist/index.jsg

返回:

农历乙巳年二月初五
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端