robokassa-mcp について
robokassa-mcp は Robokassa の決済 API に接続する MCP サーバーで、請求の作成や支払い状況の確認を行うクライアント向けです。MD5 署名付き決済 URL を生成し、任意で 54-FZ のレシートにも対応します。
主な機能
- 01MD5 署名付き決済 URL の生成
- 02請求ステータスの確認
- 03任意の 54-FZ レシート対応
- 04Streamable HTTP トランスポート
活用シーン
- 01請求用の Robokassa 決済 URL の作成
- 02Robokassa 請求の支払い状況の確認
MCP 対応
MCP クライアント向けに、決済 URL の作成と請求ステータス確認のツールを公開します。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 サーバーです。請求書の作成(MD5 署名付き)とステータス確認の 2 つのツールを提供します。
クイックスタート
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 サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。