Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client