Onchain Data MCP

onchain-data-mcp

AI アシスタントにリアルタイムのブロックチェーンデータを提供します。ウォレット残高、支払い、価格、詐欺チェックなどに対応しています。無料で始められ、登録も不要です。

Claude Desktop のボタンをクリックすると、ダブルクリックするだけで使える、必要なものがすべて含まれたファイルがダウンロードされます。 Cursor と VS Code のボタンで追加されるのは設定だけです。先にプログラムをインストールしてください。

onchain-data-mcp は、Claude、Cursor、VS Code などの AI アプリがブロックチェーンを読み取れるようにする、小さなプログラムです。Ethereum、Base、Arbitrum、Optimism、Polygon、Avalanche、BNB Chain、Robinhood Chain、Solanaに対応しています。

内部では、約 30 のデータサービス（「プロバイダー」）に問い合わせます。応答が遅い、混雑している、または停止している場合は、次のプロバイダーに自動で問い合わせます。無料のサービスを優先するため、支払いも登録もなしですぐに始められます。

ここで使われている用語をいくつか紹介します。

• MCP は、Claude などの AI アプリが外部のツールを使うための標準規格です。このプログラムは「MCP サーバー」、つまり AI アプリが使えるツールです。
• API key は、データプロバイダーに登録すると無料で発行されるパスワードです。始めるのに必要ありません。いくつか追加すると、回答がより速く、より充実します。
• Wallet address は、0xd8dA…6045 や 7xKX…9sHc のような、暗号資産ウォレットの公開「口座番号」です。

目次

• できること
• クイックスタート
• AI アプリとの接続
• ダッシュボード
• パスワードとキー
• データプロバイダー
• 利用可能なツール
• 実際の使用例
• 他のユーザー向けに実行する
• トラブルシューティング
• FAQ
• 開発者向け · セキュリティ · ライセンス

できること

AI アシスタントに普段の言葉で質問してください。適切なツールを選び、回答を取得します。

• ウォレットを確認する。 すべてのチェーンを一度に確認して、ウォレットが保有するコインやトークンを表示します。 「ウォレット 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 は何を保有していますか？」
• 支払いを確認する。 顧客が正しいアドレスに正しい額の USDC を本当に支払ったか確認します。 「Base のトランザクション 0xabc… で、私のショップのアドレスに 25 USDC が支払われましたか？」
• 安全を守る。 トークンが詐欺ではないか、アドレスが制裁リストに載っていないか、ステーブルコインの価値が下がっていないかを確認します。 「Solana のこのトークンはハニーポットですか？」 · 「USDT の価値はまだ 1 ドルですか？」
• 資金の流れを追う。 トランザクションの詳細や手数料、ウォレットの銀行明細風の取引履歴を取得します。 「先週、私のウォレットに入金された金額を、ドル換算額とあわせて表示してください。」
• 価格とスワップ。 複数の情報源からトークン価格や過去の価格、スワップの見積もりを取得します。 「今、Arbitrum で 1 ETH を USDC にスワップする最良の価格はいくらですか？」
• トークン化された株式。 Robinhood Chain の株式トークンとその価格を調べます。 「Robinhood Chain の Tesla 株式トークンの価格はいくらですか？」

データの読み取り専用です。ただし例外として、ユーザー自身のウォレットで自分で署名したトランザクションを送信できます。秘密鍵を保持することはなく、独自に資金を移動することもありません。

クイックスタート

約 5 分で完了する 3 つの手順です。

1. プログラムをインストールする

いずれかを選んでください。この作業は一度だけで済みます。

Mac または Linux（ターミナルアプリを開いて貼り付けます）：

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/madlabs-tech/onchain-data-mcp/releases/latest/download/onchain-data-mcp-installer.sh | sh

Windows（PowerShell を開いて貼り付けます）：

powershell -ExecutionPolicy Bypass -c "irm https://github.com/madlabs-tech/onchain-data-mcp/releases/latest/download/onchain-data-mcp-installer.ps1 | iex"

Homebrew（Mac または Linux）：

brew install madlabs-tech/tap/onchain-data-mcp

Claude Desktop 専用、ターミナル不要（Mac および Windows）：onchain-data-mcp.mcpb をダウンロードして、ダブルクリックします。Claude Desktop で、任意のダッシュボードパスワードとプロバイダーキーの入力を求められます。すべて空欄のままで構いません。その後、手順 3 に進んでください。

docker run -i --rm -v onchain-data-mcp-data:/data ghcr.io/madlabs-tech/onchain-data-mcp:latest --config-dir /config

docker run -d --name onchain-data-mcp -p 127.0.0.1:8787:8787 -v onchain-data-mcp-data:/data -v onchain-data-mcp-config:/config ghcr.io/madlabs-tech/onchain-data-mcp:latest
docker exec onchain-data-mcp onchain-data-mcp password --config-dir /config

cargo build --release -p onchain-data-mcp
# the program is now at target/release/onchain-data-mcp

完了したら、新しいターミナルウィンドウを開いて、動作を確認します：

onchain-data-mcp --version

インストーラーによって、プログラムはホームフォルダー内の .cargo/bin というフォルダーに配置されます（例：/Users/you/.cargo/bin/onchain-data-mcp、Windows の場合は C:\Users\you\.cargo\bin\onchain-data-mcp.exe）。

2. AI アプリを接続する

下記のAI アプリに接続するで、お使いのアプリの手順に従ってください。その後、アプリを再起動し、「読み取り可能なチェーンはどれですか？」などと質問します。

3. ダッシュボードを開く

ダッシュボードは、ウェブブラウザーで使えるコントロールパネルです。AI アプリを開いている間は、http://127.0.0.1:8787/dashboard で実行されています。ダッシュボードは、自動生成されたパスワードで保護されています。表示するには、ターミナルで次のコマンドを実行します（手順 2 で使ったものと同じフォルダーを使用してください）：

onchain-data-mcp password --config-dir ~/.onchain-data-mcp

次のような画面が表示されます：

Dashboard: http://127.0.0.1:8787/dashboard
Password:  f8460762fe006afc…
One-click login: http://127.0.0.1:8787/dashboard#login=f8460762fe006afc…
Config folder: /Users/you/.onchain-data-mcp
Source: /Users/you/.onchain-data-mcp/dashboard_password

ワンクリックログインのリンクを開けば、ダッシュボードに入れます。残りの設定はセットアップガイドに沿って進めてください。キーの追加、ツールの選択、接続を行います。

Claude Desktop バンドルを使用した場合、別のフォルダーを選んでいなければ、フォルダーは ~/.onchain-data-mcp です。

AI アプリに接続する

設定用のフォルダーを 1 つ選び、すべての場所でそれを使ってください。 ここでは ~/.onchain-data-mcp（ホームフォルダー内の .onchain-data-mcp というフォルダー）を使います。you は自分のユーザー名に置き換えてください。

フルパスを使う理由は、アプリによっては別の場所からプログラムを起動するためです。その場合、config のような相対パスでは誤ったフォルダーが使われてしまいます。フルパスなら常に正しく動作します。

Claude Desktop

1. Claude Desktop を開き、Settings → Developer → Edit Config に進みます。claude_desktop_config.json が開きます。

   • Mac：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. 以下を貼り付けます（すでに "mcpServers" 内にほかのサーバーがある場合は、そのまま残してください）。

   {
     "mcpServers": {
       "onchain-data": {
         "command": "/Users/you/.cargo/bin/onchain-data-mcp",
         "args": ["--config-dir", "/Users/you/.onchain-data-mcp"],
         "env": {
           "ODM__SERVER__DATA_DIR": "/Users/you/.onchain-data-mcp/data",
           "ALCHEMY_API_KEY": "",
           "HELIUS_API_KEY": ""
         }
       }
     }
   }
   

   • command はプログラムの場所です。which onchain-data-mcp（Mac/Linux）または where onchain-data-mcp（Windows）で確認してください。Homebrew では /opt/homebrew/bin/onchain-data-mcp に配置されます。
   • Windows では、"C:\\Users\\you\\.cargo\\bin\\onchain-data-mcp.exe" のようなパスを使用します（バックスラッシュを 2 つ重ねます）。
   • キーは省略可能です。空欄のままにするか、削除するか、後でダッシュボードに追加してください。

3. Claude Desktop を完全に終了してから、再び開きます。

Claude Code

claude mcp add onchain-data -e ODM__SERVER__DATA_DIR=$HOME/.onchain-data-mcp/data -- onchain-data-mcp --config-dir $HOME/.onchain-data-mcp

Cursor

上部の Install in Cursor ボタンをクリックするか、~/.cursor/mcp.json（または各プロジェクト内の .cursor/mcp.json）に以下を貼り付けてから、Cursor Settings → MCP で有効にします。

{
  "mcpServers": {
    "onchain-data": {
      "command": "/Users/you/.cargo/bin/onchain-data-mcp",
      "args": ["--config-dir", "/Users/you/.onchain-data-mcp"],
      "env": { "ODM__SERVER__DATA_DIR": "/Users/you/.onchain-data-mcp/data" }
    }
  }
}

VS Code

上部の Install in VS Code ボタンをクリックします。設定フォルダーを使用するには、VS Code で MCP の設定を開き、"args": ["--config-dir", "/Users/you/.onchain-data-mcp"] を追加します。

その他のアプリ（ウェブアドレス経由）

プログラムがすでに実行中の場合（たとえば、別のアプリから起動した場合や、onchain-data-mcp serve を実行した場合）、HTTP 経由の MCP に対応したアプリは次のアドレスに接続できます。

http://127.0.0.1:8787/mcp

ダッシュボードの Connect ページには、実際のパスが入力された、すぐにコピーできる設定が表示されます。

ダッシュボード

http://127.0.0.1:8787/dashboard にあるコントロールパネルです。自分のコンピューターからのみ開けます。

	ログイン。 ダッシュボードのパスワードを入力するか、onchain-data-mcp password が表示するワンクリックリンクを使用します。
	セットアップガイド。 キーの追加、ツールの選択、AI アプリの接続という 3 つのステップです。
	概要。 すべて正常に動作しているかを確認できます。また、呼び出しが発生するたびにライブリストに表示されます（最後の起動以降の件数）。
	プロバイダー。 各データサービスのプラン、キー、Test ボタン、使用状況、予算、過去 30 日間のグラフを確認できます。使用状況はスプレッドシート（CSV）としてエクスポートできます。
	ルーティング。 各ジョブで最初に呼び出すプロバイダーを設定します。ドラッグして並べ替えるか、上下の矢印を使用します。
	ツールとチェーン。 ツールとチェーンを有効または無効にします。
	クライアント。 ほかの人向けに実行する場合のみ、クライアントキーを作成・取り消し、制限を設定できます。
	接続。 Claude Desktop、Claude Code、Cursor、その他のアプリ向けの設定をコピーして貼り付けます。

パスワードとキー

キーには3種類あります。必要なのは最初の1つだけで、これは自動的に作成されます。

ダッシュボードのパスワードを確認するには、いつでも次のコマンドを実行できます。

onchain-data-mcp password --config-dir ~/.onchain-data-mcp

プログラムは起動するたびにダッシュボードのアドレスも出力しますが、パスワードは表示しません。 パスワードは、設定フォルダー内のdashboard_passwordファイルに保存されています。

ワンクリックリンクにはパスワードが含まれているため、ターミナルの履歴に残ります。 自分のコンピューターで使う分には問題ありませんが、チャットやスクリーンショットに貼り付けないでください。

自分でパスワードを設定するには、DASHBOARD_PASSWORDをスペースなしで12文字以上に設定します。 Claude Desktopの場合は、たとえば"DASHBOARD_PASSWORD": "my-long-secret-2026"のように"env"ブロックに追加します。

新しいランダムなパスワードを生成するには、次のコマンドを実行します。

onchain-data-mcp password reset --config-dir ~/.onchain-data-mcp

新しいパスワードを使うには、AIアプリ（またはプログラム）を再起動してください。

プロバイダーキーを追加するには、ダッシュボードでProvidersに移動し、キーを貼り付けてTestをクリックします。 または、"ALCHEMY_API_KEY": "your-key"のように、AIアプリの設定の"env"ブロックに追加します。

データプロバイダー

プロバイダーは4つのティアに分かれています。

おすすめ： まずはキーなしで始めてください。より良い結果が必要になったら、 AlchemyとHelius で無料キーを取得し、ダッシュボードに貼り付けてください。

利用上限とサインアップリンクを含む全リストは、**docs/VENDORS.md**にあります。

利用可能なツール

これらはAIアプリが使用できるツールです。自分で呼び出すのではなく、AIアシスタントが選択します。「プロファイル」は、すぐに使えるツールセット（payments、trading、neobank、defi）です。デフォルトではすべてのプロファイルが有効です。ダッシュボードのTools & Chainsページで、より少ないセットを選択できます。

tx_broadcastを除き、すべてのツールはデータを読み取るだけです。tx_broadcastは、すでに署名したトランザクションを送信します。

チェーンと稼働状況

ウォレット

トランザクション

決済

ステーブルコイン

ステーブルコインは、USDCやUSDTのように、1ドル（または1ユーロ）の価値を保つことを目指す暗号資産です。

コンプライアンス

資金（法定通貨と銀行業務）

市場とトークン

取引

現実資産

以前のセットアップでは、レガシーツールの eth_get_balance、eth_get_code、eth_gas_price および eth_get_transaction_by_hash も引き続き使用できます。新しいセットアップでは、上記のツールを使用してください。

実際の使用例

これらのいずれかを AI アプリにコピーしてください。

ウォレット

• 「0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 は、すべてのチェーンでどのトークンを保有していますか？」
• 「このアドレスは通常のウォレットですか、それともスマートコントラクトですか？」

決済

• 「Base 上のトランザクション 0x… は、0x… に少なくとも 25 USDC を支払いましたか？ 確定していますか？」
• 「今朝以降に Polygon 上の私の 3 つの店舗用アドレスに入金された新しい USDC を一覧表示してください。」
• 「Solana 上で、私のアドレス宛てに 10 USDC の支払いリクエストを作成してください。」

安全性

• 「このアドレスに支払う前に、制裁リストと照合してください。」
• 「Arbitrum 上の USDC は、今も 1 ドルの価値がありますか？」
• 「この新しい Solana トークンは詐欺ですか？」

資金

• 「2026-03-15 の EUR から USD への為替レートはいくらでしたか？」
• 「今月のウォレットの取引明細を、ドル換算額付きで作成してください。」
• 「暗号資産カードでの支払いが拒否されたのはなぜですか？」

取引

• 「Base 上で 500 USDC を ETH に交換する最良の見積もりを取得してください。」
• 「2026 年 1 月 1 日の SOL の価格はいくらでしたか？」
• 「現在の Ethereum のネットワーク手数料は、ドル換算でいくらですか？」

トークン化された株式

• 「この Robinhood Chain トークンは、公式の NVIDIA 株式トークンですか？ 価格はいくらですか？」

他のユーザー向けに実行する

デフォルトでは、プログラムは自分専用として、あなたのコンピューター上で実行されます（「セルフホスト」）。

サーバーに配置して、他の人やアプリに使ってもらうこともできます（「ホスト型」）。各顧客には、 それぞれの上限が設定された専用のクライアントキーが割り当てられます。すべてダッシュボードから管理できます。

手順を追ったガイドは DEPLOYMENT.md にあります。

トラブルシューティング

「missing or invalid dashboard password」

1. onchain-data-mcp password --config-dir <your folder> を実行し、表示されたパスワードを使ってください。
2. AI アプリが使用している同じフォルダーを使ってください。別のフォルダーでは、パスワードも異なります。
3. パスワードを変更した場合は、変更が反映されるように AI アプリを再起動してください。

「DASHBOARD_PASSWORD is too short」または「DASHBOARD_PASSWORD can only use plain letters…」

自分で設定するパスワードは 12 文字以上で、スペースやアクセント付き文字を含めることはできません。 修正するか、DASHBOARD_PASSWORD を削除して自動生成されたパスワードを使ってください。それまではダッシュボードは 無効のままですが（その他の機能は引き続き使えます）、ログに「dashboard turned off」と表示されます。

「The password comes from the DASHBOARD_PASSWORD setting. Change it there instead.」

自分でパスワードを設定しているため、password reset では変更できません。代わりに DASHBOARD_PASSWORD を変更してください。

「HTTP not started (Address already in use); stdio only」またはダッシュボードのページが読み込まれない

別の何かがすでにポート 8787 を使用しています（「ポート」とは、コンピューター上のドア番号のようなものです）。 よくある原因は、このプログラムの別のコピーです。たとえば、2 つの AI アプリが同時に実行している場合です。 AI アプリは引き続き使えますが、ダッシュボードだけが表示されません。もう一方のコピーを終了するか、 実行中のコピーのダッシュボードを開いてください。

AI アプリにツールが表示されない、またはサーバーの起動に失敗したと表示される

1. command のパスを確認してください。which onchain-data-mcp（Mac/Linux）または where onchain-data-mcp（Windows）を実行し、表示されたフルパスを貼り付けてください。
2. 設定テキスト（JSON）に、カンマや引用符の抜けがないことを確認してください。
3. アプリを完全に終了してから、もう一度開いてください。
4. Claude Desktop のログ：Mac ~/Library/Logs/Claude/、Windows %APPDATA%\Claude\logs/。

Mac で「onchain-data-mcp cannot be opened」または「developer cannot be verified」と表示される

これは、ファイルを手動でダウンロードした場合にのみ発生します。ファイルがあるフォルダーで、次のコマンドを一度実行してください。

xattr -d com.apple.quarantine onchain-data-mcp

Linux：「GLIBC_2.35 not found」

お使いの Linux は、あらかじめ用意されたプログラムが対応するバージョンより古いです。代わりに Docker オプションを使ってください。

「hosted mode requires at least one client key」または「hosted mode requires public_bind」

これらは、他のユーザー向けに実行する場合にのみ表示されます。DEPLOYMENT.md をご覧ください。

ツールで、チェーンがサポートされていないと表示される

その機能には、まだ追加されていないプロバイダーキーが必要です。"どのチェーンと機能を使えますか？"（chain_list ツール）と尋ねて、不足しているものを確認し、Providers ページでキーを追加してください。

FAQ

無料ですか？ はい。このプログラムは無料のオープンソース（MIT ライセンス）です。まず無料のデータサービスを利用します。 有料プランを提供しているプロバイダーもありますが、利用する必要はありません。

キーは必要ですか？ いいえ。登録不要で無料のプロバイダーを使って、すぐに動作します。無料の Alchemy キーと Helius キーを使うと、より高速で完全なデータを利用できます。

どのチェーンに対応していますか？ Ethereum、Base、Arbitrum、Optimism、Polygon、Avalanche、BNB Chain、Robinhood Chain、Solana に対応しています。

資金を移動できますか？ いいえ。ウォレットの秘密鍵を取得することはありません。ご自身のウォレットで署名するためのトランザクションを準備でき、tx_broadcast はすでに署名したトランザクションを送信できます。プログラム自体が署名することはできません。

データは安全ですか？キーはどこに保存されますか？ すべてお使いのコンピューター内に保存されます。プロバイダーのキーは設定フォルダー内の secrets.toml に保存され（Mac と Linux ではユーザー本人のみが読み取れます）、そのプロバイダーにのみ送信されます。 ダッシュボードへの接続は、お使いのコンピューターからのみ受け付けます。

設定はどこに保存されますか？ 選択したフォルダー（例：~/.onchain-data-mcp）に保存されます。設定用の config.toml、キー用の secrets.toml、dashboard_password、使用状況の数値を格納する data フォルダーがあります。

更新するにはどうすればよいですか？ インストールコマンドを再度実行するか（または brew upgrade onchain-data-mcp を実行し）、AI アプリを再起動します。 Claude Desktop の場合は、新しい .mcpb ファイルをダウンロードしてダブルクリックします。

開発者向け

REST API、設定リファレンス、ルーティング、アーキテクチャ、ビルド、テスト、リリースについては、 docs/TECHNICAL.md をご覧ください。

セキュリティ

セキュリティ上の問題を見つけた場合は、SECURITY.md の説明に従って、非公開で報告してください。

ライセンス

MIT。ダッシュボードのフォントは SIL Open Font License に基づいています （OFL.txt）。