mcpField
S
swarm-x402-mcp

swarm-x402-mcp

ローカル
github.com/swarm-agent-operator開発ツール01 週間前に更新
リポジトリ

swarm-x402-mcp について

swarm-x402-mcpは、SWARMの有料サービスを利用するエージェント向けのMCPサーバーです。リポジトリ検査やウェブ調査などを提供し、Base上のUSDCで成功時に課金します。支出上限も設定できます。

主な機能

  1. 01GitHubリポジトリの健全性検査
  2. 02ウェブ調査に基づく要約とレポート
  3. 03エンコード、ハッシュ、UUIDのツール
  4. 04URL状態確認とページ本文取得
  5. 05Base上のUSDCによる従量課金
  6. 06呼び出しごとの価格上限

活用シーン

  1. 01公開GitHubリポジトリの保守上の問題を確認
  2. 02出典付きの概要やレポートを作成
  3. 03URLの状態確認やページ本文の抽出

MCP 対応

MCPクライアントに6種類の有料ツールを提供します。ウォレットキーなしでもツールの一覧と見積もりを確認でき、設定時はBase上のUSDCで呼び出しごとに支払います。

設定

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

mcp.json · 共通設定
{
  "mcpServers": {
    "swarm-agent-operator-swarm-x402": {
      "command": "npx",
      "args": [
        "-y",
        "swarm-x402-mcp"
      ],
      "env": {
        "SWARM_WALLET_KEY": "<SWARM_WALLET_KEY>",
        "SWARM_MAX_USD": "<SWARM_MAX_USD>"
      }
    }
  }
}
起動コマンドnpx -y swarm-x402-mcp
設定が必要な環境変数
SWARM_WALLET_KEYシークレットPrivate key of a dedicated wallet with a little USDC on Base. Without it, tools only quote.
SWARM_MAX_USDRefuse any call priced above this many dollars (default 1).

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

パッケージ
npmswarm-x402-mcp0.1.3

ツール

4

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
nintegerいいえ生成する数
tstring|numberいいえ変換するタイムスタンプ
opstringはい操作。例：uuid、hash、base64、password、timestamp（https://swarm-agent.net/openapi.json を参照）
algostringいいえハッシュアルゴリズム
textstringいいえ入力テキスト。入力が必要な操作で使用します
lengthintegerいいえパスワードの長さ

詳細

swarm-x402-mcp

有料ツールを備えた MCP サーバーです。エージェントは Base 上で USDC を使い、呼び出しごとに支払います。API キーもアカウントも不要です。

x402 を通じて小規模なサービスを販売する自律型エージェント、SWARM 用の MCP サーバーです。 Claude Code、Cursor、Claude Desktop、または任意の MCP クライアントに追加できます。エージェントは SWARM のサービスを呼び出し、Base 上で USDC を使って呼び出しごとに支払えるようになります。アカウントも API キーも不要で、サービスが提供された場合にのみ課金されます。

ツール

ツールは 6 つあります。各ツールはネットワーク経由で SWARM のショップを呼び出し、ウォレットキーがある場合は USDC で支払うため、読み取り専用のツールはありません。すべてのツールで、MCP アノテーションにこのことが宣言されています（readOnlyHint: false、openWorldHint: true）。

ツール送信するもの受け取るもの価格
code_health公開 GitHub リポジトリの URL静的スキャン：TODO/FIXME の技術的負債、大きすぎるファイル、シークレットのヒューリスティック、衛生状態$0.05
summaryトピックライブウェブで調査した 1 ページの概要と、リンク付きの情報源$0.75
reportトピックライブウェブで調査した完全な Markdown レポートと、リンク付きの情報源$0.99
utilities操作（uuid、hash、base64、…）UUID、ハッシュ、base64、URL エンコード、パスワード、タイムスタンプ$0.02
site_checkURLサイトの稼働状況：HTTP ステータス、リダイレクト後の最終 URL、応答時間、TLS エラー$0.002
read_pageURLページの読みやすいテキスト（メニュー、スクリプト、マークアップは削除）$0.002

インストール

Node.js 20 以降が必要です。SWARM_WALLET_KEY には、Base 上で数ドル分の USDC のみを保有する専用ウォレットを使用してください。

Claude Code

claude mcp add --transport stdio swarm --env SWARM_WALLET_KEY=0x… --env SWARM_MAX_USD=1 -- npx -y swarm-x402-mcp

Cursor（~/.cursor/mcp.json）および Claude Desktop（Settings → Developer → Edit Config）

{
  "mcpServers": {
    "swarm": {
      "command": "npx",
      "args": ["-y", "swarm-x402-mcp"],
      "env": {
        "SWARM_WALLET_KEY": "0x…",
        "SWARM_MAX_USD": "1"
      }
    }
  }
}
  • SWARM_WALLET_KEY：支払いに使うウォレットの秘密鍵です。設定しなくてもツールの一覧表示と見積もりはできます。その場合、ツールは価格を説明し、支払いは行いません。
  • SWARM_MAX_USD（デフォルトは 1）：サーバーは署名を行う前に、この上限を超える価格の呼び出しを拒否します。

支払いの仕組み

各呼び出しでは、まず支払いを行わずに SWARM の 402 見積もりを読み込みます。ネットワークが Base mainnet であることと、価格が設定した上限未満であることを確認します。その後、公式の x402 クライアント（@x402/fetch）を使って支払います。SWARM は支払いを検証して作業を行い、作業が成功した場合にのみ決済します。

リンク

MIT ライセンス。

コメント

Markdown 対応

MCP は初めてですか？

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

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