Parsi MCP

parsi-mcp

English | فارسی

一个 MCP 服务，为 AI Agent（Claude、Cursor、VS Code Copilot 等）提供可靠的波斯语和伊朗本地化工具。它完全离线运行，无需 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"] } } }

Agent 技能（指导 Agent 优先以 RTL 方式构建波斯语 UI，并调用这些工具）：

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 时，Agent 通常会生成一个 LTR 页面，使用 margin-left 和 text-left，配上普通数字输入框和拉丁数字。

使用 parsi-mcp 时，Agent 会加载 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>

包含内容

领域	主要功能
波斯历	转换、格式化、解析、加减日期、计算日期差、日期选择器月份网格、周／月／季度／年度范围、相对时间文本（۳ روز پیش）、根据出生日期计算年龄、表单校验、工作日（周五为周末）、固定的太阳历节假日
伊朗本地化校验器	国民身份证号、法人国民身份证号、银行卡号、Sheba、手机号码、邮政编码、银行和运营商查询、电话号码显示格式、地址解析（省份、邮政编码、门牌号／单元／楼层）
波斯语文本	标准化、ZWNJ 修正、数字、基数词和序数词、文字转数字、slug、模糊搜索、波斯语排序、键盘布局修正、文本统计和阅读时间、文本方向检测和双向文本包装、安全截断、Lorem ipsum
货币	里亚尔／托曼、分组数字、金额大写、增值税辅助工具、兼容 Excel 的 CSV 导出、简写形式（۲٫۵ میلیون）、小数／百分比／分数转文字
RTL 前端	指南提示词／资源、CSS 和 Tailwind 审查、转换为逻辑属性、起始代码片段、价格输入代码片段、波斯语字体预设
数据	包含 ISO 3166-2 代码和首府的 31 个省份

数据说明

银行 BIN、Sheba 代码、手机号码前缀和省份数据只包含经公开来源确认的条目。由于无法核实可靠的离线数据，因此不包括阴历（Hijri）节假日日期、车牌解析和国民身份证号城市查询。增值税辅助工具需要你提供税率。

开发

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