pix-mcp 是一个轻量级的模型上下文协议（MCP）服务器，使 AI 智能体（如 Claude、Cursor、Windsurf）能够通过自然语言提示生成静态 Pix 二维码。
用途
该项目面向巴西即时支付生态，旨在让 AI 智能体直接创建符合 BACEN PIX 标准的静态 Pix 付款二维码，无需调用外部 API 或注册账户。
主要能力
- 提供 MCP 工具 generateStaticPix，可为任意 Pix 密钥生成静态二维码。
- 支持多种 Pix 密钥类型：邮箱（如 example@email.com）、电话（如 +5511999999999）、CPF（11 位数字）、CNPJ（14 位数字）以及随机密钥（UUID 格式）。
- 生成内容包含：EMV 格式的 Pix 复制粘贴代码、base64 数据 URL 的二维码图像，以及成功状态与消息。
- 符合 EMV 4.0 与 BACEN PIX 标准，使用 CRC16-CCITT 校验。
- 使用 TypeScript 实现，借助 Zod 进行输入校验，具备完整错误处理与日志记录。
- 零外部依赖，无需 API 密钥，无需注册或凭据。
使用方式
- 全局安装：
npm install -g pix-mcp（依据 README 提供的安装命令，实际请以仓库为准）。 - 可直接运行
npx pix-mcp或（全局安装后）pix-mcp。 - 配置到 Claude Desktop 的 MCP 配置文件中（macOS：
~/Library/Application Support/Claude/claude_desktop_config.json；Windows：%APPDATA%/Claude/claude_desktop_config.json），重启后即可使用。 - 也可配置到支持 MCP 的 Cursor、Windsurf 或其他 MCP 兼容工具中。
- MCP 工具调用参数：
pixKey（字符串）：有效的 Pix 密钥（邮箱、电话、CPF、CNPJ 或随机密钥）。amount（数字）：以巴西雷亚尔计的付款金额（0.01 到 999,999.99）。recipientName（字符串）：收款人姓名（最多 25 字符）。recipientCity（字符串）：收款人所在城市（最多 15 字符）。
- 环境变量：
MCP_MODE：服务器模式（stdio用于 MCP，http用于 HTTP API），默认stdio。NODE_ENV：环境（development/production），默认development。PORT：HTTP 模式下的端口，默认 3000。
- 部署到 Railway 后，需在 Railway 仪表板添加上述环境变量。
适用场景
- 在 AI 智能体对话中直接生成 Pix 收款二维码。
- 需要快速创建符合巴西 Pix 标准的静态付款码的客服、电商或自动化流程。
- 与 Claude、Cursor、Windsurf 等 MCP 兼容工具集成，提供自然语言生成二维码的能力。
限制与注意事项
- 仅支持静态 Pix 二维码：无过期时间，收款人需手动核对付款。
- CPF/CNPJ 密钥必须有效且已注册为 Pix 密钥。
- 避免使用虚假 CPF（如 12345678900），银行会拒绝。
- 所有代码均符合 EMV 标准并通过银行验证，但金额范围限制在 0.01 到 999,999.99 巴西雷亚尔。
- 许可协议为 MIT。
