vn-skills

Name: vn-skills
Author: beiryu

本地服务

github.com/beiryu商业与营销01 天前更新

代码仓库

关于 vn-skills

vn-skills 是一个 stdio MCP 服务，将越南格式和服务相关函数提供为工具，适用于需要支付、地址、税号、日期、姓名及电子发票处理能力的客户端。

主要功能

01生成、解析和解码 VietQR
02解析和转换越南地址
03验证越南税号
04将金额转换为文字
05转换公历和农历日期
06验证电子发票并计算总额

适用场景

01创建或检查 VietQR 支付数据
02规范化越南地址记录
03核验税号和电子发票总额
04转换日期及金额格式

MCP 相关

通过 stdio MCP 服务将 vn-skills 函数作为工具提供。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "beiryu-vn-skills": {
      "command": "npx",
      "args": [
        "-y",
        "@vn-skills/mcp"
      ]
    }
  }
}

启动命令npx -y @vn-skills/mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@vn-skills/mcp0.7.0stdio

工具

收录的工具列表 · 更新于 4 天前

参数	类型	必填	说明
bank	string	是	银行 BIN、代码或名称，例如 "VCB"、"970436"、"Vietcombank"
note	string	否	转账备注／用途
image	boolean	否	同时返回 PNG 图像（base64）。默认值为 false。
amount	number\|string	否	VND 金额（整数）。静态 QR 时省略。
account	string	是	收款人账号

README 原文English

来自项目 README

README 暂无中文译文，以下为英文原文；中文介绍见上方。

@vn-skills/mcp

MCP server (stdio) exposing the vn-skills functions as tools.

claude mcp add vn-skills -- npx -y @vn-skills/mcp

{ "mcpServers": { "vn-skills": { "command": "npx", "args": ["-y", "@vn-skills/mcp"] } } }

Tools: vietqr_build, vietqr_parse, vietqr_decode, vietqr_banks, vn_address_parse, vn_address_convert, vn_address_search_wards, vn_tax_id_validate, vn_money_to_words, vn_lunar_from_solar, vn_lunar_to_solar, vn_lunar_holidays, vn_einvoice_validate, vn_einvoice_totals, vn_einvoice_mock_issue, vn_name.