mcpField
X
x402 Conformance

x402 Conformance

ローカル
github.com開発ツール11 日前に更新

x402 Conformance について

x402 Conformanceは、決済対応サーバーをテストする開発者やエージェント向けのx402決済チェックを提供します。CLIやCI連携と同じチェックとレポートを使い、支払いや署名、メインネットへのアクセスは行いません。

主な機能

  1. 01未払い時の402応答を検証
  2. 02サーバーの決済安全性を検査
  3. 03組み込みデモでチェックを実行
  4. 04チェック項目と失敗理由を説明
  5. 05匿名の失敗事例を準備

活用シーン

  1. 01有料エンドポイントの402応答を確認
  2. 02決済完了前に内容が配信されないか検証
  3. 03デモサーバーでチェックを再現

MCP 対応

MCPサーバーはx402適合性チェックと関連機能をツールとして公開します。ファシリテーターのダブルとリソースサーバーの検査ツールはMCP専用です。支払いや署名は行いません。

設定

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

mcp.json · 共通設定
{
"mcpServers": {
"atsp-protocol-x402-conformance": {
"command": "npx",
"args": [
"-y",
"x402-conformance-mcp"
]
}
}
}
起動コマンドnpx -y x402-conformance-mcp

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

パッケージ
npmx402-conformance-mcp1.6.0
ocighcr.io/atsp-protocol/x402-conformance:1.6.0

ツール

7

掲載時のツール一覧 · 4 日前に更新

パラメーター型必須説明
urlstringはい有料 URL(http または https)

詳細

x402-conformance-mcp

MCP クライアント(Claude、Cursor、VS Code、Windsurf など)、Vercel AI SDK、LangChain 向けの、x402 の適合性チェックと安全性チェックをツールとして提供します。オープンソースの x402-conformance スイートへの軽量なエントリーポイントです。CLI、GitHub Action、テストマッチャーと同じチェック、チェック ID、レポートを使用します。支払い、署名、メインネットへのアクセスは一切行いません。

MCP

{ "mcpServers": { "x402-conformance": { "command": "npx", "args": ["-y", "x402-conformance-mcp"] } } }
ツール機能
x402_check_payment_required有料 URL に対して未払いの GET リクエストを 1 回送信し、その 402 応答をチェックします(P1-P7)
x402_demo組み込みのデモサーバーに対してスイート全体を実行します。ウォレットもセットアップも不要です。fault: serve_on_any_settle で失敗を確認できます
x402_start_facilitator_doubleループバック上でファシリテーターのダブルを起動します。サーバーをその URL に向けてください
x402_probe_resource_serverループバック上のサーバーに対して R0-R10 を実行します。タイムアウト、壊れた応答、settlement_pending、失敗、重複が発生した場合、コンテンツは返しません
x402_stop_facilitator_doubleダブルを停止します
x402_explain_checkチェックの内容と失敗時の修正方法を説明します
x402_share_case匿名化されたコーパス事例と、事前入力済みの課題リンクを用意します。何も送信されないため、ユーザーが判断できます

次のように尋ねてみてください:「x402 のデモを実行して」「http://127.0.0.1:4020/paid の 402 応答をチェックして」、または「ファシリテーターのダブルを起動して。サーバーを接続するので、その後 http://127.0.0.1:4020/paid をプローブして」。

Vercel AI SDK

import { generateText } from "ai";
import { x402ConformanceTools } from "x402-conformance-mcp/ai-sdk";

await generateText({ model, tools: x402ConformanceTools(), prompt: "Is the 402 answer at https://api.example.com/paid valid x402?" });

LangChain と LangGraph

import { createReactAgent } from "@langchain/langgraph/prebuilt";
import { x402ConformanceTools } from "x402-conformance-mcp/langchain";

const agent = createReactAgent({ llm, tools: x402ConformanceTools() });

AI SDK と LangChain のアダプターは、エージェントに 4 つの読み取り専用ツール(チェック、デモ、説明、共有)を提供します。ダブルとプローブのツールは、ユーザーが操作する MCP に残ります。

コーパス

失敗レポートは、公開されている x402 の実際の障害事例コーパスの匿名化された事例にできます。 x402_share_case が事例を準備してリンクを返します。ユーザーは内容を確認して送信するか、送信しないかを選べます。各レポートには、生成元のエントリーポイント(via: mcp、ai-sdk、langchain)がレポートと User-Agent に記載されます。それ以外の識別情報はなく、テレメトリーもありません。

Apache-2.0。Ryan Gillespie、Optitransfer。

コメント

MCP は初めてですか?

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

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