mcpbeat Sign in

Chinese Almanac MCP Server

by yonlandwu Your server? Claim it
local only

Chinese Almanac MCP runs on your own machine — the client starts it, so there is no endpoint to ping. 67 installs a week from npm. Last commit 3 Oct 2026.

Chinese almanac (黄历) MCP: date selection, daily almanac, solar terms, zodiac horoscopes.

Installs per day peak 16 · avg 7 · -15% w/w
a month agotoday
67
Installs / week
npm · chinese-almanac-mcp
0
Stars
0 open issues
3 Oct 2026
Last commit
4 releases in 90 days
MIT
License
JavaScript

What the code does

We read the source, 2 h ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Runs an external command src/smoke.ts:15
const child = spawn(process.execPath, [SERVER], { stdio: ["pipe", "pipe", "pipe"] });

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add chinese-almanac-mcp -- npx -y chinese-almanac-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "chinese-almanac-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "chinese-almanac-mcp"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.chinese-almanac-mcp]
command = "npx"
args = ["-y", "chinese-almanac-mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "chinese-almanac-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "chinese-almanac-mcp"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "chinese-almanac-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "chinese-almanac-mcp"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: TUNGSHING_API_KEY (Optional free API key from 12Zodiacs.com for ±365-day range (anonymous allows ±90 days)).

Alternatives to Chinese Almanac MCP

same job, measured the same way
Sky and Signs — horoscopes and sky calendars
by skyandsigns

Daily horoscopes (en/es/pt, 7 days ahead), moon phases, Panchang, solar terms, Maya, Ramadan dates.

8 tools answering
Chinese Astrology MCP Server by RoxyAPI
by roxyapi

BaZi four pillars, Chinese zodiac, lunisolar calendar and almanac days for AI agents.

16 tools answering
Icyn Date
by icyn12-tinker

Date context for agents: Chinese lunar calendar, solar terms, holidays for 12 regions. Offline.

58 installs/wk local only
Rosis Morgenhimmel — Tageshoroskop und Himmelskalender
by morgenhimmel

Daily horoscopes (de/en/es, 7 days ahead), moon phases, Panchang, solar terms, Maya calendar.

8 tools answering
Netcafe Almanac
by ainetcafe

Chinese almanac: lunar calendar, BaZi 八字, daily 宜忌, lucky-day picker, public holidays.

6 tools answering
Zotero Bridge
by combjellyshen

MCP Server for Zotero SQLite Database - collection, tagging, PDF reading and more.

33 installs/wk local only
FateTell
by fatetell

Deterministic BaZi (Four Pillars) charts, Chinese almanac and saved FateTell charts.

9 tools answering
Nooxus MCP
by robertglools

Nooxus Edge Data MCP: Search AI-verified Chinese manufacturers, eliminate B2B hallucinations.

104 installs/wk local only

Chinese Almanac MCP — questions

Answers built from our own checks of this server.

Why is there no uptime for Chinese Almanac MCP?
Chinese Almanac MCP runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package chinese-almanac-mcp was installed 67 times last week.
How do I connect Chinese Almanac MCP?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls chinese-almanac-mcp straight from npm; nothing to host, nothing to sign up for.
How many people use Chinese Almanac MCP?
The npm package chinese-almanac-mcp was installed 67 times in the last week. Week over week that is -15%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Chinese Almanac MCP open source?
Yes — it is published under the MIT licence, written in JavaScript and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.