Jalali MCP Server

What is Jalali MCP Server?

A Node.js server for processing Jalali (Persian) dates, holidays, and special events, designed for Model Context Protocol (MCP) applications. It provides fast, accurate calendar data for AI systems.

How to use Jalali MCP Server?

Clone the repository, install dependencies with npm install, then run with npm start. To use the MCP UVX server (requires Python and uv), run npm run install then npm run server. For Claude Desktop, add the provided NPX configuration to claude_desktop_config.json. For VS Code, use the one-click buttons or add the configuration to your user settings or .vscode/mcp.json.

Key features of Jalali MCP Server

• Fast Node.js server for Jalali (Persian) date processing
• Handles holidays and special events
• Optimized for Model Context Protocol (MCP) applications
• Can be run via NPX without installation
• Supports both standard and UVX (with Python) execution

Use cases of Jalali MCP Server

• AI assistants providing Persian date conversions and holiday information
• Chatbots that need to answer date-related queries in the Jalali calendar
• Scheduling or event systems that rely on Persian holidays
• MCP‑based tools requiring Persian calendar awareness

FAQ from Jalali MCP Server

What does Jalali MCP Server do?

It processes and returns Jalali (Persian) dates, holidays, and special events, optimized for use by MCP‑compatible applications like AI assistants.

How can I install and run Jalali MCP Server?

Clone the repository, run npm install, then start with npm start. For UVX mode (requires Python and uv), run npm run install first, then npm run server.

Do I need Python to use the server?

Only if you use the UVX mode (npm run server). The standard npm start mode does not require Python.

How do I configure Jalali MCP Server with Claude Desktop?

Add the NPX configuration block from the README to your claude_desktop_config.json as shown in the “Usage with Claude Desktop” section.

What are the dependencies for running Jalali MCP Server?

Node.js and npm. For UVX execution, Python and the uv tool are also required.