Spraay X402 Mcp Server

Name: Spraay X402 Mcp Server
Author: plagtech

ローカル

github.com/plagtech開発ツール417 週間前に更新

リポジトリ

Spraay X402 Mcp Server について

Spraay X402 Mcp Serverは、MCPクライアントをSpraayゲートウェイに接続し、オンチェーンデータ、AIサービス、暗号資産操作を提供します。x402によるUSDCのリクエスト単位決済に対応し、ローカルウォレットとリモート決済を選べます。

主な機能

01ゲートウェイ各分野の183ツール
02一括送金、スワップ、給与、エスクロー
03オンチェーンデータ、分析、調査
04AI推論とコンピューティング
05無料で使える24のエンドポイント

活用シーン

01MCPクライアントからオンチェーン操作を実行
02複数の宛先へ一括送金
03価格、残高、取引データを照会
04有料リクエストでAI推論を利用

MCP 対応

183のツールを通じてSpraayゲートウェイの機能をMCPクライアントに公開します。x402によるUSDC決済に対応し、ローカルウォレットでの署名とゲートウェイ側でのリモート決済を選べます。

#x402 #payments #crypto #defi #base #usdc #onchain #batch-payments #swap #ai

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "spraay-x402": {
      "command": "npx",
      "args": [
        "-y",
        "spraay-x402-mcp"
      ],
      "env": {
        "X402_WALLET_PRIVATE_KEY": "<X402_WALLET_PRIVATE_KEY>"
      }
    }
  }
}

起動コマンドnpx -y spraay-x402-mcp

設定が必要な環境変数

X402_WALLET_PRIVATE_KEYシークレットPrivate key for the wallet that pays for x402 requests (USDC on Base)

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npmspraay-x402-mcp3.1.1stdio

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

💧 Spraay x402 MCP サーバー

AI エージェント向けのフルスタック DeFi インフラストラクチャ — 183 個の従量課金ツールを提供。Base 上の 192 エンドポイントを備える Spraay x402 Gateway を基盤とし、Solana、Ethereum、XRP、Stellar の決済レールに対応しています。

Claude、Cursor、または任意の MCP クライアントを、オンチェーン決済、一括支払い、スワップ、ブリッジ、給与支払い、請求、エスクロー、オラクルデータ、分析、200 以上の AI モデル、GPU／コンピューティング、リサーチ API、検索／RAG などに接続します。エージェントは x402 protocol 経由でリクエストごとに USDC を支払います — API キーもアカウントも不要です。

ツールリストはビルド時にライブゲートウェイのマニフェストから生成されるため（npm run sync）、正確なカタログと料金は常にゲートウェイで管理されています — 詳しくはツールカタログをご覧ください。ゲートウェイのエンドポイントのうち 24 個は無料です（支払い不要）。

クイックスタート

インストールしてすぐに利用できます — 設定も API キーも環境変数も不要です。 初回起動時にサーバーがウォレットを自動作成し、~/.spraay/.session に保存して、アドレスを stderr に出力します。そのアドレスに Base 上の USDC を入金すれば、ツールを呼び出せます。

セキュリティとウォレットの安全性をお読みください — これらのツールは実際の資金を扱います。

ワンライナーインストール（Claude Code）

claude mcp add spraay -s user -- npx -y spraay-x402-mcp

手動設定（Cursor／Claude Desktop）

Cursor（.cursor/mcp.json）または Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "spraay": {
      "command": "npx",
      "args": ["-y", "spraay-x402-mcp"]
    }
  }
}

以上です。初回起動時には、次のように表示されます：

💧 Spraay created a new wallet: 0xABC…123
   Private key saved to ~/.spraay/.session (keep it safe — it controls funds).
   Fund this address with USDC on Base to start paying for tool calls.

オプション — 自分のウォレットを使用する

自動作成されたウォレットではなく、すでに自分で管理しているキーで署名するには、環境変数に EVM_PRIVATE_KEY を設定してください（セッションウォレットより優先されます）。 生のキーをコミット済みの設定ファイルに貼り付けないでください — エージェントが使用できる金額だけを入金した専用のホットウォレットを使用してください。詳しくはセキュリティとウォレットの安全性をご覧ください。

リモート URL（お使いのマシンにウォレットは不要）

決済はゲートウェイ側で処理されるため、クライアントが署名キーを保持することはありません。

{
  "mcpServers": {
    "spraay": {
      "url": "https://spraay-x402-mcp--plagtech.run.tools"
    }
  }
}

Smithery

smithery mcp add Plagtech/Spraay-x402-mcp

ソースからのインストール

git clone https://github.com/plagtech/spraay-x402-mcp
cd spraay-x402-mcp
npm install
npm run build
npm start                     # auto-creates a wallet on first run

ツールカタログ

ゲートウェイの33カテゴリにわたる183のツールを提供しています。分野ごとの主な内容は次のとおりです。

分野	対応内容
AIと推論	200以上のLLM（OpenAI互換）、ウォレット／トランザクション分類、コントラクトの説明、要約
コンピューティング	Replicate、Chutes、OpenRouterを利用したテキスト／画像／動画／TTS／STT／埋め込み処理、バッチジョブ
コンピューティング先物	階層型割引のある前払いコンピューティングクレジット。推論ごとに消費
Bittensor	SN64／SN19を介した分散型推論、画像生成、埋め込み
決済	最大200件の受取先への一括送金（Base、XRP Ledger、Stellar）、見積もり
給与計算	Base、Ethereum、Solanaでのステーブルコイン給与支払い
請求書とエスクロー	暗号資産ネイティブの請求書とマイルストーン型エスクロー（永続的）
DeFiとデータ	スワップ（Uniswap V3／Aerodrome）、オラクルによる価格／ガス／為替レート、ブリッジ見積もり、残高、ENS／Basename
分析	ウォレットプロファイルとデコード済みトランザクション履歴
調査	2億5,000万件以上の論文（OpenAlex）、arXiv、Crossref、PubMed、PubChem、米国国勢調査、辞書
検索とRAG	ウェブ検索、コンテンツ抽出、質問応答
コミュニケーション	メール、SMS、XMTPメッセージング、Webhook
インフラストラクチャ	マルチチェーンRPC、IPFS／Arweaveストレージ、cronスケジューリング、構造化ログ
IDとコンプライアンス	KYC／制裁対象者スクリーニング、認証セッション、監査証跡、暗号資産税務（FIFO、IRS 8949）
サプライチェーン（SCTP）	サプライヤー登録、発注書、請求書検証、決済
ロボティクス（RTP）	ロボット登録、有償タスクの割り当て、エスクローで保証された完了
信頼と安全性	ProofLayerの信頼スコア。無料のトークン安全性、アドレス安全性、トランザクションデコードのチェック

24の無料エンドポイントは支払い不要です。ガス代／価格／チェーンステータス、アドレスとバッチの検証、ENS解決、単位変換、x402の検出プローブ、モデル／コンピューティングの検出が含まれます。

最新の正確なツール一覧とツールごとの料金を確認するには、ライブマニフェストを照会してください。

curl https://gateway.spraay.app/.well-known/x402.json

料金は$0.001（読み取り）から約$0.10（給与支払い、エスクロー解除、税務）までで、Base上のUSDCで決済されます。

仕組み

エージェントがツール（例：spraay_batch_execute）を呼び出します。
MCP サーバーがSpraay x402 Gatewayに接続します。
ゲートウェイがUSDCの金額を示す402 Payment Requiredを返します。
リモートモード： 決済はゲートウェイ側で処理されます。 ローカルモード： @x402/axiosが、自動作成された（または差し替えた）ウォレットからUSDCの少額決済に署名します。
ゲートウェイが支払いを検証し、データを返します。

セキュリティとウォレットの安全性

これらのツールは実際のUSDC決済を開始する場合があります。資金にアクセスできる他のツールと同様に、サーバーを慎重に扱ってください。

自動作成されたウォレットに保管されるのは、入金した額だけです。 エージェントに使わせてもよい額だけを入金してください。最初は空なので、入金するまでは新規インストールから資金を動かすことはできません。読み取り専用ツールはその場合でも利用できます。
セッションキーは~/.spraay/.sessionに保存されます。 このファイルは秘密情報と同様に保護してください。読み取れる人は誰でもウォレットを操作できます。POSIXシステムでは0600の権限で書き込まれます。資金が重要な場合はバックアップしてください。ファイルを削除すると、次回実行時に新しいウォレットに切り替わります。
署名キーをマシンに保存したくない場合は、リモートURLの使用をおすすめします。決済はゲートウェイ側で処理されます。
EVM_PRIVATE_KEYを使って独自のキーを用意する場合は、他の資産を管理していない専用のホットウォレットを使用し、生の秘密鍵を設定ファイル、issue、コミットされるファイルに絶対に記載しないでください。シェル環境変数のみに保存してください。

公開されているnpmパッケージに含まれるのはdist/、README、LICENSEのみです（npm pack --dry-runで確認できます）。バイナリ、ビルドツール、インストールスクリプトは含まれていません。

セキュリティ上の問題は公開issueではなく、[email protected]に報告してください。

要件

Node.js 20+
MCP クライアント — Claude Desktop、Cursor、またはその他のMCP互換クライアント
Base上のUSDC — 自動作成されたウォレット（または独自のウォレット）に入金します。$1でも数千回の呼び出しに対応できます

環境変数

必須の変数はありません。サーバーは設定不要で実行できます。以下はすべて任意で設定を上書きできます。

変数	必須	デフォルト	説明
`EVM_PRIVATE_KEY`	いいえ	`~/.spraay/.session` に自動作成	自動作成されるウォレットを独自のキーで上書きします。必要な資金を入れた専用のホットウォレットを使用してください。
`SPRAAY_GATEWAY_URL`	いいえ	`https://gateway.spraay.app`	ゲートウェイ URL を上書きします。

リンク

MCP サーバー： mcp.spraay.app
ゲートウェイ： gateway.spraay.app
マニフェスト： gateway.spraay.app/.well-known/x402.json
Smithery： smithery.ai/servers/Plagtech/Spraay-x402-mcp
x402： x402.org

ライセンス

MIT

Markdown 対応

ログインしてコメント

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。