vietnamese-calendar MCP server

Add the server

claude mcp add --transport http vietnamese-calendar https://am-lich.com/mcp

Verify it's connected

claude mcp list

Sharing it with your team?

Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

Use it in a session

Ask Claude to use the tools this server exposes (e.g. convert_date_lunar2solar, convert_date_solar2lunar, get_canchi). It discovers them automatically.

Open your MCP config

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this server

{
  "mcpServers": {
    "vietnamese-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://am-lich.com/mcp"
      ]
    }
  }
}

Why the wrapper?

This is a remote (HTTP) server and Claude Desktop only launches local processes, so mcp-remote proxies the connection. It will open a browser window if the server needs OAuth.

Restart Claude Desktop

The tools appear under the 🔌 menu once the app reloads.

Create / edit .cursor/mcp.json in your project

{
  "mcpServers": {
    "vietnamese-calendar": {
      "url": "https://am-lich.com/mcp"
    }
  }
}

Enable it

Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

Add to ~/.codex/config.toml

[mcp_servers.vietnamese-calendar]
command = "npx"
args = ["-y", "mcp-remote", "https://am-lich.com/mcp"]

Why the wrapper?

Codex runs MCP servers as local processes, so mcp-remote bridges this HTTP endpoint to stdio.

Run Codex

Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

Edit ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "vietnamese-calendar": {
      "serverUrl": "https://am-lich.com/mcp"
    }
  }
}

Reload

Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

Open Cline → MCP Servers → Configure

Adds to cline_mcp_settings.json.

Add the server

{
  "mcpServers": {
    "vietnamese-calendar": {
      "type": "streamableHttp",
      "url": "https://am-lich.com/mcp"
    }
  }
}

Create .vscode/mcp.json

{
  "servers": {
    "vietnamese-calendar": {
      "type": "http",
      "url": "https://am-lich.com/mcp"
    }
  }
}

Start it

VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.