lunar-mcp

MCP Server for Chinese Calendar

简介

基于 lunar-go 实现的 MCP 服务器，提供中国农历、八字、风水等传统日历能力给 AI Agent 使用。

功能

分类	工具
基础	lunar_date, zodiac_bazi, solar_terms, festivals
日历	solar_calendar, month_calendar, year_calendar
八字	eight_char_full, advanced_bazi, destiny_analysis, fortune_periods
命理	date_selector, marriage_compat, name_generator
高级	iching_divination, nine_star_flying
神煞	shen_sha, pengzu_baiji

快速开始

Docker

docker run -d -p 8080:8080 ghcr.io/xiaoyijiang-c/lunar-mcp:latest

本地运行

go build -o lunar-mcp .
./lunar-mcp

API

# 健康检查
curl http://localhost:8080/health

# 查询农历
curl -X POST http://localhost:8080/rpc \
  -d '{"method":"tools/call","params":{"name":"lunar_date","arguments":{"year":2026,"month":3,"day":5}}}'