Chinese Almanac MCP Server

by yonlandwuio.github.yonlandwu/chinese-almanac-mcpv1.0.2

Chinese almanac (Tung Shing): daily readings, hour-pillar luck ratings, NASA JPL-based solar terms, auspicious dates, zodiac horoscopes and lucky hours.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active6d ago

Install Chinese Almanac MCP server

claude mcp add chinese-almanac -e TUNGSHING_API_KEY='<tungshing-api-key>' -- npx -y chinese-almanac-mcp

{
  "mcpServers": {
    "chinese-almanac": {
      "command": "npx",
      "args": [
        "-y",
        "chinese-almanac-mcp"
      ],
      "env": {
        "TUNGSHING_API_KEY": "<tungshing-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "chinese-almanac": {
      "command": "npx",
      "args": [
        "-y",
        "chinese-almanac-mcp"
      ],
      "env": {
        "TUNGSHING_API_KEY": "<tungshing-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "chinese-almanac": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "chinese-almanac-mcp"
      ],
      "env": {
        "TUNGSHING_API_KEY": "<tungshing-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "chinese-almanac": {
      "command": "npx",
      "args": [
        "-y",
        "chinese-almanac-mcp"
      ],
      "env": {
        "TUNGSHING_API_KEY": "<tungshing-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
TUNGSHING_API_KEY	—	yes	Optional free API key from 12Zodiacs.com for ±365-day range (anonymous allows ±90 days).

Freshness

Active — last maintenance signal 6d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-03 · 6d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-08-26 · 45d ago · official registry · v1.0.2

FAQ

›How do I install the Chinese Almanac MCP server in Claude Code?

Run: claude mcp add chinese-almanac -e TUNGSHING_API_KEY='<tungshing-api-key>' -- npx -y chinese-almanac-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Chinese Almanac require an API key?

Yes. It expects TUNGSHING_API_KEY, of which 1 is a secret.

›Can I use Chinese Almanac as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Chinese Almanac in the official MCP registry?

Yes, as io.github.yonlandwu/chinese-almanac-mcp.