cipher-x402-mcp

cipher-x402-mcp

任意の MCP 対応クライアント（Claude Desktop、Cursor、Cline、Continue など）で利用できる、Solana／暗号資産／マクロ関連の 8 つのツールを提供する MCP サーバーです。ツールのうち 7 つは x402 決済プロトコルで保護されており、エージェントは Base 上で USDC による支払いを自動で行います。ツール呼び出しごとに $0.005～$0.25 です。1 つのツールは無料です（教育目的）。

このサーバーは一方向のみのリレーです。エージェントが X-PAYMENT ヘッダーなしで有料ツールを呼び出した場合、上流からの HTTP 402 と許可リストをそのまま返すため、エージェント自身のウォレットで決済に署名できます。呼び出し元の資金を預かることはありません。

無料で、MIT ライセンスです。 フォークして、自由に独自のものを公開してください。

---

ホスト型プラン（MCPize）

セルフホストを希望しない場合は、ゲートウェイプロキシ、レート制限、API キー認証、請求の一元化に対応したマネージドサービスを MCPize で利用できます。

mcpize.com/mcp/cipher-x402-mcp

プラン	料金	リクエスト数／月	レート制限	内容
無料	$0	100	10／分	無料ツール＋solana_wallet_scan
Starter	$9	1,000	60／分	読み取り専用ツール 4 種（scan、HIBP、repo health、FRED）
Pro（おすすめ）	$29	5,000	120／分	8 つすべてのツール、GitHub 優先サポート
Team	$99	25,000	600／分	8 つすべてのツール＋上流のカスタム設定、24 時間以内の応答 SLA

MCPize のゲートウェイ経由で従量課金されます。セルフホストは引き続き無料です（このリポジトリ、MIT）。

---

ツール

ツール	料金（USDC、Base）	上流
solana_wallet_scan(address)	$0.01	cipher-scan-three.vercel.app
check_password_breach(sha1_prefix)	$0.005	cipher-pwned.vercel.app
jito_tip_calculator(pool_depth, expected_profit, slot_prob)	$0.01	cipher-jito-tip.vercel.app
github_repo_health(owner, repo)	$0.02	cipher-repo-health.vercel.app
fred_macro_series(series_id)	$0.005	cipher-fred.vercel.app
check_drift_exposure(wallet)	$0.01	cipher-drift-exposure.vercel.app
solana_wallet_security_audit_rules()	無料	ローカル（v1.1.0 ルールセット）
get_premium_cipher_chapter(slug)	$0.25	cipher-x402.vercel.app

ネットワークは Base、USDC アセットは 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 です。現在の x402 支払い受取先は、実行時にルート / の JSON マニフェストから確認できます。エージェントが自動的に検出するため、手動で設定する必要はありません。

インストール（Claude Desktop）

以下を ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加してください。

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

Claude Desktop を再起動してください。ツールトレイに 8 つのツールが表示されます。

インストール（Cursor／Cline／Continue）

MCP-over-stdio クライアントであれば、同じ方法で利用できます。起動コマンドは npx -y cipher-x402-mcp です。

インストール（Smithery）

npx -y @smithery/cli install cipher-x402-mcp --client claude

リモート HTTP トランスポート

**https://cipher-x402-mcp.vercel.app/mcp**（ストリーミング可能な HTTP）にデプロイされています。ルート URL でマニフェストを確認してください。

支払いの仕組み

1. エージェントは、支払いなしで（例：）solana_wallet_scan({ "address": "..." }) を呼び出します。
2. サーバーは、HTTP 402 Payment Required — upstream returned an x402 accept-list. で始まる構造化された結果を返し、 続けて JSON の許可リスト（価格、ネットワーク、payTo、asset など）を返します。
3. エージェントのウォレットが、提示された maxAmountRequired に対する EIP-3009 認証に署名します。
4. エージェントは、同じツールを次の内容で再度呼び出します。 { "address": "...", "_payment": "<base64-signed-header>" }。
5. サーバーは X-PAYMENT ヘッダーをアップストリームに転送し、アップストリームのファシリテーターが Base 上で検証して決済すると、コンテンツがエージェントに返されます。

サーバー自体はステートレスです。API キー、ユーザーセッション、資金は不要です。

---

🏃 自分で実行する

前提条件

• Node.js 20+（22 推奨）
• npm 10+
• HTTP トランスポートをデプロイする場合は Vercel アカウント（無料プラン可）
• ローカルで stdio を使用する場合、API キーは不要です。サーバーは公開アップストリームエンドポイントへのパススルーです

クローンしてビルド

git clone https://github.com/cryptomotifs/cipher-x402-mcp
cd cipher-x402-mcp
npm install
npm run build
npm run smoke     # tool-registry smoke test
npm start         # stdio transport
npm run start:http  # HTTP transport on :8080

独自のアップストリームエンドポイントを設定する（任意）

すべてのアップストリームのベース URL は環境変数で上書きできます。アップストリームエンドポイントを自分の Vercel プロジェクトにフォークし、MCP サーバーからそこへルーティングしたい場合に便利です。

CIPHER_SCAN_API_URL=https://your-scan.example.com \
CIPHER_PWNED_URL=https://your-pwned.example.com \
CIPHER_JITO_TIP_URL=https://your-jito.example.com \
CIPHER_REPO_HEALTH_URL=https://your-repo-health.example.com \
CIPHER_FRED_URL=https://your-fred.example.com \
CIPHER_DRIFT_URL=https://your-drift.example.com \
CIPHER_X402_URL=https://your-x402.example.com \
  npx cipher-x402-mcp

Vercel にデプロイする

vercel link
vercel --prod

/mcp ルートは MCP JSON-RPC メッセージを提供し、/ はレジストリで使用される軽量な JSON マニフェストを提供します。

---

🛒 購入

MCP が役に立ち、さらに深く活用したい方向けに、少額の有料サイドカーをいくつか用意しています。すべて直接決済で、プラットフォームの仲介はありません。

• cipher-checkout.vercel.app — 3 つの商品を、カード（Stripe）または暗号資産（Base USDC、Solana USDC、BTC）で購入できます。
  • x402 Paid Endpoint Starter Kit — $19 — Next.js 16 のスターターリポジトリ + 7 ページのチュートリアル PDF + Vercel にワンコマンドでデプロイ。ファシリテーターに対して X-PAYMENT を検証する、動作する x402 エンドポイントです。
  • Solana Solo-Dev Playbook (PDF) — $9 — 2026 年に Solana と x402 の開発を一人で行う開発者向けに、トレーディング、リスク、セキュリティ、アーキテクチャ、収益、コンプライアンス、インフラを解説した 150 ページのプレイブックです。
  • Solana Bot Toolkit Walkthrough — $29 — オープンソースの cipher-solana-bot-toolkit を詳しく解説します（5 つのモジュール：フラッシュローン、ボリュームボット、アービトラージ／MEV、ミームコインのローンチ、コピートレード）。

マネージド MCPize リスティングでも利用できます：mcpize.com/mcp/cipher-x402-mcp — 月額無料 / $9 / $29 / $99。

---

🙏 サポート

これは無料で、MIT ライセンスです。時間の節約になった場合は、SOL でのチップを歓迎します。

cR9KrbsLVJvir5rY9cfY3WeNoxMwUGofzpCoVyobryy

無理のない範囲でどうぞ。リポジトリにスターを付けたり、共有したりしていただくことも、同じようにありがたいです。

---

💼 ご依頼について

カナダ・オンタリオ州在住の個人開発者です（ET）。x402／MCP／Solana の統合作業を週20時間まで承ります。

固定料金のサービス：

#	サービス	料金	期間
1	お客様の Next.js / Node アプリに x402 を組み込みます — マージ済み PR ＋ ライブテスト	$900	2日
2	x402 または Solana ボットのアーキテクチャ設計＋セキュリティレビュー — 書面のレポート＋60分の通話	$1000	1日
3	AI エージェント向け有料 API：0 から MCP ラッパー付きで Base 上に公開	$1200	3日

時間単価： 対象範囲を問わず $150/時、最低5時間単位です。40時間以上を前払いの場合は $125/時です。

お支払い： Base 上の USDC 0x2a33D2414312e8776dA4011c2586c2d067267210、Solana 上の USDC cR9KrbsLVJvir5rY9cfY3WeNoxMwUGofzpCoVyobryy、またはご要望に応じて Wise-USD。

ご依頼方法： このリポジトリでタイトルを[Consulting]: <what you need>として Issue を作成するか、@[email protected] まで DM をお送りください。1時間以内に、作業範囲と50%の前金のお支払い先を返信します。

納品する決済経路の堅牢化についての解説： dev.to/sai_93caeceb4f6a4d9969910/shipped-x402-paid-endpoint-starter-kit-nextjs-16-5g39

その他： Solana／x402／MCP 開発者向けのプロンプトパックを cipher-checkout.vercel.app で提供しています — Anchor の監査、x402 ＋ MCP の設計、Solana ボットのエンジニアリング、暗号資産開発の生産性向上を網羅する5つのパックと、20%オフのバンドルがあります。カードまたは暗号資産でお支払いいただけます。

---

関連プロジェクト

• cipher-starter — MIT ライセンスの無料 Solana 個人開発者向けプレイブック (github.com/cryptomotifs/cipher-starter).
• cipher-solana-bot-toolkit — MIT ライセンスの無料ツールキット：フラッシュローンルーター、ボリュームボット、アービトラージ／MEV 捕捉ボット、ミームコイン発行ツール、コピートレーダー — 機密情報を除去した5つのモジュール (github.com/cryptomotifs/cipher-solana-bot-toolkit).
• cipher-solana-wallet-audit — 平文の Solana 秘密鍵がある場合に CI を失敗させる、無料の GitHub Action（v1.1.0） (github.com/cryptomotifs/cipher-solana-wallet-audit).

ニッチな x402 エンドポイント（暗号資産以外のエージェント向け）

• cipher-x402-pubmed — 1回あたり $0.005、PubMed の医学文献検索 (cipher-x402-pubmed.vercel.app).
• cipher-x402-osm — 1回あたり $0.001、OpenStreetMap のジオコーディング＋逆ジオコーディング (cipher-x402-osm.vercel.app).
• cipher-x402-usda — 1回あたり $0.002、USDA FoodData Central の栄養情報検索 (cipher-x402-usda.vercel.app).
• cipher-x402-fda — 1回あたり $0.005、openFDA の医薬品有害事象検索 (cipher-x402-fda.vercel.app).

ライセンス

MIT — LICENSE をご覧ください。