jalali-mcp-server

pfndesign/jalali-mcp-server

3.1

If you are the rightful owner of jalali-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Jalali MCP Server is a Node.js server for processing Jalali dates, holidays, and events, optimized for MCP applications.

Jalali MCP Server

A simple, fast Node.js server for processing Jalali (Persian) dates, holidays, and special events — optimized for ModelContextProtocol (MCP) applications.

📦 Install

Clone the repository and install the dependencies:

git clone https://github.com/pfndesign/jalali-mcp-server.git
cd jalali-mcp-server
npm install

🚀 Run

Start the server normally:

npm start

Or start using ModelContextProtocol UVX server (requires Python and uv):

npm run install # to install uv and mcpo
npm run server

Usage with Claude Desktop

Setup Add this to your claude_desktop_config.json:

NPX

{
  "mcpServers": {
    "jalaliCalendar": {
      "command": "npx",
      "args": [
        "-y",
        "git+https://github.com/pfndesign/jalali-mcp-server.git"
      ]
    }
  }
}

VS Code Installation Instructions

For quick installation, use one of the one-click installation buttons below:

Install with NPX in VS Code Install with NPX in VS Code Insiders

For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open Settings (JSON).

Optionally, you can add it to a file called .vscode/mcp.json in your workspace. This will allow you to share the configuration with others.

Note that the mcp key is not needed in the .vscode/mcp.json file.

NPX
{
  "mcp": {
    "servers": {
      "memory": {
        "command": "npx",
        "args": [
          "-y",
          "git+https://github.com/pfndesign/jalali-mcp-server.git"
        ]
      }
    }
  }
}

✨ About

This project is designed for MCP-based AI systems that need fast, accurate Jalali (Persian) date processing, holiday awareness, and smart event tracking.