关于 robokassa-mcp
robokassa-mcp 是连接 Robokassa 支付 API 的 MCP 服务,面向需要创建账单并查询付款状态的客户端。它提供带 MD5 签名的付款链接生成,并支持可选的 54-FZ 收据。
主要功能
- 01生成带 MD5 签名的付款链接
- 02查询账单状态
- 03支持可选的 54-FZ 收据
- 04提供 Streamable HTTP 传输
适用场景
- 01为账单生成 Robokassa 付款链接
- 02检查 Robokassa 账单付款状态
MCP 相关
该 MCP 服务向 MCP 客户端提供创建付款链接和查询账单状态的工具。可通过 stdio 或 Streamable HTTP 连接。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
2收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 否 | 买家的收据电子邮件地址 | |
| invId | integer | 是 | 账单编号(订单的唯一 ID)。0 = 自动生成 |
| items | array | 否 | 收据项目(54-ФЗ;如需财政化) |
| outSum | number | 是 | 以卢布计的支付金额 |
| culture | enum | 否 | 支付界面语言ru | en |
| description | string | 是 | 订单说明(最多 100 个字符) |
| expirationDate | string | 否 | 账单有效期,采用 ISO 8601 格式(例如 2025-12-31T23:59:59) |
详细介绍
@theyahia/robokassa-mcp
适用于 Robokassa 支付 API 的 MCP 服务。提供 2 个工具,用于创建发票(使用 MD5 签名)和查询状态。
快速开始
Claude Desktop
{
"mcpServers": {
"robokassa": {
"command": "npx",
"args": ["-y", "@theyahia/robokassa-mcp"],
"env": {
"ROBOKASSA_LOGIN": "your-login",
"ROBOKASSA_PASSWORD1": "your-password1",
"ROBOKASSA_PASSWORD2": "your-password2"
}
}
}
}
Claude Code
claude mcp add robokassa -e ROBOKASSA_LOGIN=login -e ROBOKASSA_PASSWORD1=pass1 -e ROBOKASSA_PASSWORD2=pass2 -- npx -y @theyahia/robokassa-mcp
Cursor / Windsurf
{
"robokassa": {
"command": "npx",
"args": ["-y", "@theyahia/robokassa-mcp"],
"env": {
"ROBOKASSA_LOGIN": "your-login",
"ROBOKASSA_PASSWORD1": "your-password1",
"ROBOKASSA_PASSWORD2": "your-password2"
}
}
}
工具
| 工具 | 描述 |
|---|---|
create_invoice | 使用 MD5 签名创建支付 URL,可选提供 54-FZ 收据 |
check_invoice | 通过 OpStateExt XML 接口查询发票状态 |
身份验证
| 变量 | 必填 | 描述 |
|---|---|---|
ROBOKASSA_LOGIN | 是 | 商户登录名 |
ROBOKASSA_PASSWORD1 | 是 | 密码 1(用于支付签名) |
ROBOKASSA_PASSWORD2 | 是 | 密码 2(用于状态查询签名) |
ROBOKASSA_TEST | 否 | 设置为 "true" 可启用测试模式 |
HTTP 传输
HTTP_PORT=3000 npx @theyahia/robokassa-mcp
# or
npx @theyahia/robokassa-mcp --http 3000
端点:POST /mcp(JSON-RPC)、GET /health(状态)。
技能
- skill-create-invoice -- 创建带 MD5 签名的 Robokassa 支付 URL
- skill-check-payment -- 通过 OpStateExt 查询发票状态
许可证
MIT
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。