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:

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.