Parsi MCP

io.github.amirjld由 GitHub 帳號 amirjld 發布v0.3.0更新於 Oct 26, 2026

Offline Persian/Iran tools: Jalali dates, validators, Persian text, price inputs, RTL frontend.

已驗證STDIO僅桌面位置與生活開發者工具

概覽

AI 產生的概覽

離線 MCP 伺服器，提供 56 個波斯語與伊朗在地化工具：Jalali 日期、伊朗驗證器、波斯文處理、金額格式化和 RTL 前端輔助。

可以做什麼
  • 轉換、格式化、解析與計算 Jalali 日期差值，產生月曆格線與週/月/季/年區間，計算年齡與工作日
  • 驗證伊朗身分證號、金融卡、Sheba 號、手機號與郵遞區號，並查詢銀行、電信業者與地址資訊
  • 正規化波斯文，修正 ZWNJ 與數字，數字與波斯語數詞互轉，排序、模糊搜尋、方向偵測與安全截斷
  • 格式化里亞爾與土曼金額，把價格寫成文字，計算加值稅，匯出 Excel 安全的 CSV
  • 取得 RTL 規範、檢查 CSS 與 Tailwind、轉換為邏輯屬性，並取得起始範本與價格輸入片段
  • 查詢伊朗 31 個省份及其 ISO 代碼與首府
適用情境
適合需要產生波斯語內容或面向伊朗市場的表單與頁面：Jalali 日期選擇器、含里亞爾價格的結帳頁、身分證或 Sheba 驗證，以及 RTL 版面工作。也適合清理波斯文與把數字轉成文字。
執行需求
以 npm 套件形式透過 stdio 在本機執行，需要 Node.js 18+；README 說明 npx 安裝需等套件發布到 npm，否則從原始碼建置。未宣告任何 API 金鑰或環境變數，完全可離線使用。
安裝前請注意
加值稅工具需要你自己提供稅率；README 明確指出因無法核實可靠的離線資料，未包含伊斯蘭曆節日日期、車牌解析與身分證城市查詢。銀行、Sheba、手機號段與省份資料僅涵蓋公開確認的項目，驗證結果不宜視為權威。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Parsi MCP，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

parsi-mcp

English | فارسی

An MCP server that gives AI agents (Claude, Cursor, VS Code Copilot and others) reliable Persian and Iran-specific tools. It runs fully offline, with no API keys: Jalali dates, Iranian validators, Persian text handling, grouped price inputs with Persian words, and an RTL frontend toolkit.

56 tools. See the full list in TOOLS.md.

Install

Requires Node.js 18+. The npx commands below work once the package is published to npm; until then use the local build.

Claude Code

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

Or install the plugin, which adds the MCP server and the persian-rtl-frontend skill:

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

Cursor (~/.cursor/mcp.json or .cursor/mcp.json in a project)

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

Claude Desktop (claude_desktop_config.json: %APPDATA%\Claude\ on Windows, ~/Library/Application Support/Claude/ on macOS)

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

VS Code (.vscode/mcp.json)

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

Agent skill (tells agents to build Persian UIs RTL-first and to call these tools):

bash
npx skills add amirjld/parsi-mcp

From source

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

Before and after

You ask: "Build a checkout page in Persian with a price field."

Without parsi-mcp, agents typically produce an LTR page with margin-left and text-left, a plain number box, and Latin digits.

With parsi-mcp, the agent loads the RTL guidelines, takes rtl_starter_snippet for the layout and price_input_snippet for the field, and validates payment fields with validate_card_number and validate_sheba:

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

What is inside

AreaHighlights
Jalali calendarconvert, format, parse, add, diff, month grid for date pickers, week/month/quarter/year ranges, relative text (۳ روز پیش), age from birth date, form validation, business days (Friday weekend), fixed solar holidays
Iranian validatorsnational ID, legal-entity national ID, bank card, Sheba, mobile, postal code, bank and operator lookup, phone display formats, address parsing (province, postal code, plaque/unit/floor)
Persian textnormalization, ZWNJ fixes, digits, number and ordinal words, words to number, slugs, fuzzy search, Persian sort, keyboard-layout fix, text stats and reading time, direction detection and bidi wrapping, safe truncation, lorem ipsum
Moneyrial/toman, grouped digits, price in words, VAT helper, Excel-safe CSV export, short forms (۲٫۵ میلیون), decimals/percents/fractions in words
RTL frontendguidelines prompt/resource, CSS and Tailwind audit, converters to logical properties, starter snippets, price input snippets, Persian font presets
Data31 provinces with ISO 3166-2 codes and capitals

Data notes

Bank BINs, Sheba codes, mobile prefixes and province data only include entries confirmed by public sources. Lunar (Hijri) holiday dates, vehicle plate parsing and national-ID city lookup are not included because reliable offline data could not be verified. The VAT helper needs you to supply the rate.

Develop

bash
npm installnpm run buildnpm testnpm run docs:tools   # regenerate TOOLS.md (a test fails if it is out of date)

Each tool is a small pure function in src/lib, registered in src/server.ts. Contributions are welcome.

Releasing

See the maintainer steps in RELEASING.md.

License

MIT

來源：README.md，提交 9a1e66f

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.3.0最新Oct 18, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分