💳 MSU MCP服务器
MCP（模型上下文协议）服务器，用于从MSU（MerchantSafe Unipay）支付网关查询支付交易。
✨ 特性
- 🔍 使用全面的过滤选项查询支付交易
- 👤 查询客户详细信息
- 🌐 自动将错误代码转换为人类可读的土耳其语描述
- 📊 TOON格式响应 -LLM的令牌高效数据编码（比JSON少约40%的令牌）
- 🤖 用于AI模型上下文的MCP协议集成
- ⚡ CLI工具，易于部署
⚙️ 配置
🔐 环境变量
设置以下环境变量：
export MSU_MERCHANT="your_merchant_id"
export MSU_MERCHANT_USER="your_merchant_user"
export MSU_MERCHANT_PASSWORD="your_merchant_password"🔧 MCP服务器配置
要与MCP兼容的应用程序（如Claude Desktop）集成，请将以下内容添加到MCP配置中：
{
"mcpServers": {
"msu-mcp": {
"command": "npx",
"args": ["-y", "github:bcihanc/msu-mcp"],
"env": {
"MSU_MERCHANT": "your-merchant-id",
"MSU_MERCHANT_USER": "your-user",
"MSU_MERCHANT_PASSWORD": "your-password"
}
}
}
}🔍 可用工具
交易查询工具
这 query_transaction 该工具支持以下过滤方式：
- 🆔 交易编号 (
pgtranid) - 📅 日期范围 (
start_date,end_date采用dd-MM-yyyy-HH:MM格式） - 💼 商户付款ID (
merchant_payment_id) - 👤 客户详情 （姓名、电子邮件、电话、系统ID）
- 📊 交易状态
- 📄 分页 （偏移，限制-默认值1000）
客户查询工具
这 query_customer 该工具支持通过以下方式进行查询：
- 🆔 客户系统ID (
customer)-唯一商户系统ID（最多128个字符） - 👤 客户名称 (
customer_name)-客户名称（最多128个字符） - 📧 客户电子邮件 (
customer_email)-客户电子邮件地址（最多64个字符） - 📱 客户电话 (
customer_phone)-客户电话/手机号码（最多64个字符）
🔧 错误代码增强
服务器通过以下方式自动增强MSU API响应：
- 🔍 检测ERR#####格式的错误代码
- 🌐 添加土耳其语解释以更好地调试
- 🔄 保留原始响应结构
📊 TOON格式响应
所有回复均以 TOON（面向令牌的对象表示法） 使用LLM时，采用最佳令牌效率的格式。
示例响应：
status: success
merchant: TEST_MERCHANT
total_count: 2
transactions[2]{pgtranid,merchant_payment_id,amount,currency,status,customer_name,error_code}:
PG123456789,ORDER_001,"150.50",TRY,AP,Ahmet Yılmaz,""
PG987654321,ORDER_002,"299.99",USD,FA,Mehmet Demir,ERR10010
error_explanations:
ERR10010: "İstekte zorunlu parametrelerden biri bulunamadı"优点：
- 📉 代币数量减少约50% 与JSON（优化的CSV样式格式）相比
- 🎯 CSV样式数组 -字段名声明一次，然后只有值
- 📋 单独的错误图 -根级别的错误解释，而非内联
- 🔍 人类可读，同时针对LLM进行了优化
- 🔄 无损往返JSON转换
了解更多： https://github.com/toon-format/toon
🛠️ 技术细节
- 🟢 Node.js：>=18.0.0为必填项
- 🔗 协议：MCP（模型上下文协议）
- 🔌 API：MSU商品安全Unipay v2
- 📝 数据格式：表单编码请求，TOON格式响应
- 📊 响应编码：TOON（面向令牌的对象表示法），带逗号分隔符
- 🚀 运输标准： stdio
🌐 API集成
- 🔗 基础URL:
https://merchantsafeunipay.com/msu/api/v2 - ⚡ 行动:
QUERYTRANSACTION - 🔐 认证：通过表单数据获取商户凭证
- 🚨 错误代码：ERR10010-ERR30005，带有土耳其语描述
📁 项目结构
msu-mcp/
├── bin/
│ └── msu-mcp.js # 🚀 CLI executable
├── src/
│ ├── index.js # 🖥️ Main MCP server
│ └── error-codes.js # 🔧 Error code mappings
├── package.json
├── CLAUDE.md # 📖 Development guidance
└── README.md📄 许可证
麻省理工学院
👨💻 作者
齐汉