Mcp Server For Ai To Blockchain Interactions — Balances, Swaps, Transfers, Gas, Prices. Non Custodial. Multi Chain. について
@y0exchange/mcpは、AIエージェント向けのマルチチェーンDeFi MCPサーバーで、資産情報や見積もり、トランザクション作成を提供します。書き込み操作では未署名トランザクションを作成し、秘密鍵をサービスに渡さず、ユーザー自身のデバイスで署名します。
主な機能
- 01残高と複数チェーンのポートフォリオ確認
- 02価格、ガス、スワップ見積もりの取得
- 03トランザクション履歴の確認
- 04未署名のスワップと送金トランザクション作成
- 05Ethereum、BNB Chain、Arbitrum、Base、Polygonに対応
活用シーン
- 01複数チェーンの資産と米ドル評価額の確認
- 02スワップ見積もりとガス費用の比較
- 03デバイスでの署名前にスワップや送金を準備
MCP 対応
stdioまたはStreamable HTTP経由で、DeFi情報の取得とトランザクション作成ツールをMCPクライアントに公開します。読み取りツールはAPIキーなしで利用でき、スワップと送金にはY0_API_KEYが必要です。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
8掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| address | string | いいえ | ウォレットアドレス(0x...)。API キーが設定されている場合は省略可能です。 |
| chainId | number | いいえ | チェーン ID(デフォルト:Ethereum は 1)。対応値:1、56、42161、8453、137 |
詳細
@y0exchange/mcp
AI エージェントが暗号資産を取引できます。ノンカストディアル。マルチチェーン。MCP サーバーは 1 つ。
これは何ですか?
@y0exchange/mcp は、AI エージェントに DeFi へのリアルタイムアクセスを提供する Model Context Protocol サーバーです。残高、価格、ガス代、スワップ見積もり、取引履歴を確認できるほか、スワップや送金も実行できます。
Claude、ChatGPT、または MCP 対応の AI クライアントに接続できます。ユーザーは AI と会話し、AI はブロックチェーンとやり取りします。
User → AI Agent → @y0exchange/mcp → Blockchain
↓
y0 Signing Service (user signs on their device)
設計上ノンカストディアルです。 y0 が秘密鍵に触れることはありません。書き込み操作では未署名のトランザクションが作成され、ユーザーは常に自分のデバイスで署名します。
クイックスタート
1. API キーを取得する
app.y0.exchange にサインインし、API Keys → キーをコピーします。
2. コネクターを追加する(推奨)
最も簡単な方法です。Claude Desktop、claude.ai、Claude Mobile、ChatGPT で利用できます。
- AI アプリを開く → Settings → Connectors → Add custom connector
- 名前:
y0 - URL:
https://mcp.y0.exchange/mcp?key=YOUR_API_KEY - 保存すれば完了です!
インストールも設定ファイルもターミナルも不要です。API キーはウォレットに紐付いているため、AI エージェントはアドレスと権限を自動的に認識します。
開発者向け IDE(Cursor、Windsurf)の場合
MCP 設定に追加します(例:.cursor/mcp.json)。
{
"mcpServers": {
"y0": {
"command": "npx",
"args": ["-y", "@y0exchange/mcp"],
"env": {
"Y0_API_KEY": "y0_your_api_key_here"
}
}
}
}
Claude Code
claude mcp add --transport http y0 https://mcp.y0.exchange/mcp?key=YOUR_API_KEY
任意の MCP クライアント(stdio)
Y0_API_KEY=y0_... npx @y0exchange/mcp
サーバーは stdio 経由で通信し、任意の MCP クライアントと互換性があります。
読み取り専用モード
Y0_API_KEY がなくても、読み取り専用ツール(残高、価格、ガス代、見積もり、履歴)は引き続き利用できます。アカウントを作成せずに試す場合は、キーを省略してください。
リモートサーバー(HTTP)
ホスト型リモートサーバー mcp.y0.exchange は、上記のコネクター方式を支えています。セルフホストすることもできます。
リモートサーバーをセルフホストする
# Build
pnpm --filter @y0exchange/mcp build
# Run
pnpm --filter @y0exchange/mcp start:remote
# Or with Docker
docker build -f mcp/Dockerfile -t y0-mcp-remote .
docker run -p 3100:3100 \
-e SIGNING_SERVICE_URL=https://api.y0.exchange \
-e ZEROX_API_KEY=your_key \
y0-mcp-remote
リモートサーバーは以下を公開します。
POST /mcp— Streamable HTTP MCP エンドポイントGET /health— ヘルスチェック
環境変数 PORT で待ち受けポートを設定します(デフォルト:3100)。
stdio との違い
stdio(npx) | リモート(HTTP) | |
|---|---|---|
| 実行場所 | ユーザーのマシン | サーバー |
| トランスポート | stdin/stdout | Streamable HTTP |
| モバイルでの利用 | いいえ | はい |
| claude.ai での利用 | いいえ | はい |
| 認証 | Y0_API_KEY 環境変数 | URL の ?key= または Authorization ヘッダー |
| デプロイ | 不要(npm) | Docker/任意の Node.js ホスト |
ツール
読み取り専用 — そのまま利用可能、API キー不要
| ツール | 説明 |
|---|---|
get_balance | 任意のウォレットのネイティブトークンおよび ERC-20 トークンの残高 |
get_portfolio | USD 評価額を含む、全チェーンの集約ポートフォリオ |
get_price | 24 時間の変動率を含むリアルタイムのトークン価格 |
get_quote | ルーティングのプレビュー、手数料、ガス代の見積もりを含むスワップ見積もり |
get_gas | チェーンごとのガス価格と USD 建てコストの見積もり |
get_history | スマート分類機能付きの取引履歴 |
書き込み — Y0_API_KEY が必要です
| ツール | 説明 |
|---|---|
swap | 署名されていないスワップ tx を作成 → ユーザーがデバイス上で承認 |
send | 署名されていない送金 tx を作成 → ユーザーがデバイス上で承認 |
書き込みツールは、API キーを使ってウォレットを識別します。AI エージェントにアドレスを尋ねさせる必要はありません。API キーから自動的に解決されます。
対応チェーン
| チェーン | ID | ステータス |
|---|---|---|
| Ethereum | 1 | 本番環境 |
| BNB Chain | 56 | 本番環境 |
| Arbitrum | 42161 | 本番環境 |
| Base | 8453 | 本番環境 |
| Polygon | 137 | 本番環境 |
設定
すべての設定は環境変数で行います。読み取り専用ツールでは、必須の環境変数はありません。
コア
| 変数 | 説明 | デフォルト |
|---|---|---|
Y0_API_KEY | y0 API キー(swap/send に必要) | — |
SIGNING_SERVICE_URL | y0 Signing Service のエンドポイント | https://api.y0.exchange |
スワッププロバイダー
| 変数 | 説明 |
|---|---|
ZEROX_API_KEY | 0x のスワップ API キー(最初に試します) |
ONEINCH_API_KEY | 1inch のスワップ API キー(フォールバック) |
ブロックエクスプローラー(get_history 用)
| 変数 | 説明 |
|---|---|
ETHERSCAN_API_KEY | Etherscan API キー |
BSCSCAN_API_KEY | BSCScan API キー |
ARBISCAN_API_KEY | Arbiscan(Etherscan キーにフォールバック) |
BASESCAN_API_KEY | BaseScan(Etherscan キーにフォールバック) |
POLYGONSCAN_API_KEY | PolygonScan(Etherscan キーにフォールバック) |
価格情報
| 変数 | 説明 |
|---|---|
COINGECKO_API_KEY | CoinGecko Pro キー(任意。無料プランも利用できます) |
スワップの仕組み
1. User says: "Swap 1 ETH to USDC"
2. AI calls get_quote → shows price, fees, slippage
3. User confirms → AI calls swap (no wallet address needed — resolved from API key)
4. MCP authenticates with y0 Signing Service via Y0_API_KEY
→ builds unsigned transaction
→ sends push notification to user's mobile app
5. User reviews and signs on their device (biometric + wallet)
6. Transaction executes on-chain
秘密鍵がデバイスの外に出ることはありません。 MCP サーバーと y0 Signing Service が扱うのは、署名されていないトランザクションのペイロードのみです。
会話の例
「ポートフォリオの価値はいくらですか?」
AI が
get_portfolioを呼び出し → チェーン別の内訳、トークンの配分、合計 USD 価値を返します
「今、Base でスワップするとガス代はいくらかかりますか?」
AI が chainId 8453 を指定して
get_gasを呼び出し → ガス価格と、さまざまな tx タイプの USD 換算額を返します
「Arbitrum で 500 USDC を ETH にスワップして」
AI が
get_quoteを呼び出し → 予想される受取額を表示 → ユーザーが確認 →swapが署名されていない tx を作成 → ユーザーが署名します
「0.5 ETH を vitalik.eth に送って」
AI が
sendを呼び出し → 署名されていない送金を作成 → ユーザーがデバイス上で署名します
スキル:よりスマートな DeFi ワークフロー
MCP サーバーを使うと、Claude は DeFi ツールを利用できます。y0 DeFi Skill は、残高を確認してからスワップする、ガス代について警告する、最適なチェーンを提案する、DeFi のベストプラクティスに自動的に従うなど、ツールの使い方を Claude に教えます。
追加される機能
- スワップ前の安全確認(残高、ガス代、スリッページの推奨)
- 集中リスクの警告を含むポートフォリオ分析
- クロスチェーンのガス代比較とルーティングの提案
- 書き込み操作の前に必ず確認を求める手順
- 専門知識:ステーブルコインのスリッページ、ネイティブトークンの準備金、テストトランザクションの推奨
スキルをインストールする
Claude.ai:
- スキルをダウンロード
- Settings → Capabilities → Skills に移動します
- Upload skill をクリックし、ダウンロードした
skill.zipを選択します - y0 MCP コネクターも接続されていることを確認します
Claude Code:
# Place the skill folder in your Claude Code skills directory
cp -r skill/ ~/.claude/skills/y0-defi-assistant/
動作を確認する
Claude に 「暗号資産のポートフォリオを確認して」 と尋ねます。Claude が自動的に get_portfolio を呼び出し、わかりやすい内訳を提示して、集中リスクやガス代の最適化機会があれば知らせるはずです。
B2B パートナー向け
AI を活用したトレーディング製品を構築していますか? y0 がインフラを提供します。
- MCP サーバー — このパッケージをあらゆる AI エージェントに接続できます
- 署名 UI — ホワイトラベルのトランザクション承認ウィジェット
- 署名サービス — トランザクションの構築とライフサイクル管理を担うマネージドバックエンド
- B2B ポータル — API キー、使用状況ダッシュボード、請求
連携を設定するには、お問い合わせください。
アーキテクチャ
┌───────────────────────────────────────────────────────────┐
│ AI Agents │
│ Claude Desktop / Claude Code / Cursor / GPT / custom │
│ claude.ai / Claude Mobile │
└──────────┬───────────────────────────────┬────────────────┘
│ stdio (local) │ HTTP (remote)
│ npx @y0exchange/mcp │ .../mcp?key=YOUR_API_KEY
▼ ▼
┌──────────────────────────────────────────────────────────┐
│ @y0exchange/mcp │
│ │
│ ┌─────────────────┐ ┌──────────────────┐ │
│ │ Read Tools │ │ Write Tools │ │
│ │ │ │ │ │
│ │ get_balance │ │ swap ─────────────► y0 Signing │
│ │ get_portfolio │ │ send ─────────────► Service │
│ │ get_price │ │ │ │
│ │ get_quote │ └──────────────────┘ │
│ │ get_gas │ │
│ │ get_history │ │
│ └────────┬─────────┘ │
└───────────┼───────────────────────────────────────────────┘
│
┌────────▼─────────┐
│ Blockchain RPCs │
│ CoinGecko API │
│ 0x / 1inch APIs │
│ Block Explorers │
└───────────────────┘
Mobile / Web (claude.ai, Claude Mobile):
Uses remote HTTP server — no local process needed.
Desktop / CLI (Claude Desktop, Claude Code, Cursor):
Can use either stdio (npx) or remote HTTP.
開発
# Clone the monorepo
git clone https://github.com/y0exchange/y0exchange.git
cd y0exchange
# Install dependencies
pnpm install
# Build
pnpm --filter @y0exchange/mcp build
# Run stdio server (local dev)
pnpm --filter @y0exchange/mcp start
# Run remote HTTP server (local dev)
pnpm --filter @y0exchange/mcp start:remote
# Watch mode (rebuilds on change)
pnpm --filter @y0exchange/mcp dev
ライセンス
MIT — 製品で自由にご利用いただけます。詳細は LICENSE をご覧ください。
y0.exchange が開発 — AI ネイティブな DeFi インフラ
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。