pfndesign/jalali-mcp-server
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:
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.