Jalali MCP Server

Jalali MCP Server

Jalali（ペルシャ暦）の日付、祝日、特別なイベントを処理する、シンプルで高速な Node.js サーバーです。ModelContextProtocol（MCP）アプリケーション向けに最適化されています。

📦 インストール

リポジトリをクローンし、依存関係をインストールします。

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

🚀 実行

サーバーを通常の方法で起動します。

npm start

または、ModelContextProtocol UVX サーバーを使用して起動します（Python と uv が必要です）。

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

Claude Desktop での使用方法

セットアップ 以下を claude_desktop_config.json に追加します。

NPX

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

VS Code のインストール手順

すばやくインストールするには、以下のワンクリックインストールボタンを使用します。

手動でインストールするには、以下の JSON ブロックを VS Code のユーザー設定（JSON）ファイルに追加します。Ctrl + Shift + P を押して Preferences: Open Settings (JSON) と入力すると、設定を開けます。

任意で、ワークスペース内の .vscode/mcp.json というファイルに追加することもできます。これにより、設定を他のユーザーと共有できます。

.vscode/mcp.json ファイルでは、mcp キーは不要です。

NPX

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

✨ 概要

このプロジェクトは、高速で正確な Jalali（ペルシャ暦）の日付処理、祝日への対応、スマートなイベント追跡を必要とする、MCP ベースの AI システム向けに設計されています。