Parsi MCP

parsi-mcp

English | فارسی

AI エージェント（Claude、Cursor、VS Code Copilot など）に、信頼性の高いペルシャ語およびイラン固有のツールを提供する MCP サーバーです。API キー不要で完全にオフラインで動作し、ジャラーリー暦の日付、イランの各種バリデーター、ペルシャ語テキストの処理、ペルシャ語の文字表記を添えた桁区切り価格入力、RTL フロントエンドツールキットを備えています。

56 個のツールを収録しています。全リストは TOOLS.md をご覧ください。

インストール

Node.js 18 以降が必要です。以下の npx コマンドはパッケージが npm に公開されると使用できます。それまではソースからのビルドをご利用ください。

Claude Code

claude mcp add parsi -- npx -y parsi-mcp

または、MCP サーバーと persian-rtl-frontend スキルを追加するプラグインをインストールしてください。

claude plugin marketplace add amirjld/parsi-mcp
claude plugin install parsi@parsi-mcp

Cursor（~/.cursor/mcp.json またはプロジェクト内の .cursor/mcp.json）

{ "mcpServers": { "parsi": { "command": "npx", "args": ["-y", "parsi-mcp"] } } }

Claude Desktop（claude_desktop_config.json：Windows では %APPDATA%\Claude\、macOS では ~/Library/Application Support/Claude/）

{ "mcpServers": { "parsi": { "command": "npx", "args": ["-y", "parsi-mcp"] } } }

VS Code（.vscode/mcp.json）

{ "servers": { "parsi": { "type": "stdio", "command": "npx", "args": ["-y", "parsi-mcp"] } } }

エージェントスキル（ペルシャ語 UI を RTL 優先で構築し、これらのツールを呼び出すようエージェントに指示します）：

npx skills add amirjld/parsi-mcp

ソースからビルド

git clone https://github.com/amirjld/parsi-mcp.git
cd parsi-mcp && npm install && npm run build
# then use: { "command": "node", "args": ["/absolute/path/to/parsi-mcp/dist/index.js"] }

使用前と使用後

「ペルシャ語の価格入力欄があるチェックアウトページを作って」と依頼します。

parsi-mcp を使わない場合、エージェントは通常、margin-left と text-left を使った LTR ページ、単純な数字入力欄、ラテン数字を生成します。

parsi-mcp を使う場合、エージェントは RTL ガイドラインを読み込み、レイアウトには rtl_starter_snippet、入力欄には price_input_snippet を使用し、validate_card_number と validate_sheba で支払い欄を検証します。

<html lang="fa" dir="rtl">
  
  <input inputmode="numeric" value="۲۰۰٬۰۰۰" />
  <p aria-live="polite">دویست هزار تومان</p>
</html>

内容

分野	主な機能
ジャラーリー暦	変換、書式設定、解析、加算、差分、日付選択用の月間カレンダー、週・月・四半期・年の範囲、相対表記（۳ روز پیش）、生年月日からの年齢計算、フォーム検証、営業日（週末は金曜日）、固定の太陽暦祝日
イランのバリデーター	国民 ID、法人用国民 ID、銀行カード、シェバ、携帯電話、郵便番号、銀行と通信事業者の照会、電話番号の表示形式、住所解析（州、郵便番号、番地／住戸／階）
ペルシャ語テキスト	正規化、ZWNJ の修正、数字、数詞と序数詞、単語から数値への変換、スラッグ、あいまい検索、ペルシャ語の並べ替え、キーボード配列の修正、テキスト統計と読了時間、文字方向の検出と双方向テキストのラップ、安全な切り詰め、lorem ipsum
金額	リアル／トマン、桁区切り、金額の文字表記、VAT ヘルパー、Excel 対応 CSV エクスポート、短縮表記（۲٫۵ میلیون）、小数・パーセント・分数の文字表記
RTL フロントエンド	ガイドラインのプロンプト／リソース、CSS と Tailwind の監査、論理プロパティへの変換、スタータースニペット、価格入力スニペット、ペルシャ語フォントのプリセット
データ	ISO 3166-2 コードと州都を含む 31 州

データに関する注記

銀行 BIN、シェバコード、携帯電話のプレフィックス、州のデータには、公開情報で確認できた項目のみが含まれています。オフラインで信頼できるデータを確認できなかったため、太陰暦（ヒジュラ暦）の祝日、車両ナンバープレートの解析、国民 ID による都市の照会は含まれていません。VAT ヘルパーを使うには、税率を指定する必要があります。

開発

npm install
npm run build
npm test
npm run docs:tools   # regenerate TOOLS.md (a test fails if it is out of date)

各ツールは src/lib にある小規模な純粋関数で、src/server.ts に登録されています。コントリビューションを歓迎します。

リリース

メンテナー向けの手順は RELEASING.md をご覧ください。

ライセンス

MIT