About Jalali MCP Server
Jalali MCP Server is a Node.js server for MCP applications that need Jalali date, holiday, and special-event processing. It focuses on Persian calendar data for AI systems.
Key features
- 01Process Jalali dates
- 02Provide holiday information
- 03Track special events
Use cases
- 01Query Jalali dates in AI applications
- 02Identify Jalali holidays
- 03Handle Persian-calendar events
MCP support
The server exposes Jalali date, holiday, and special-event processing to MCP clients.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEJalali 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
mcpkey is not needed in the.vscode/mcp.jsonfile.
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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.