Blockrun MCP

🚀 @blockrun/mcp

BlockRun MCPは、Claude Code内でGPT - 5、Gemini、DeepSeekなどの30以上のAIモデルにアクセスできるソリューションです。APIキー不要、統一ウォレット、従量制課金といった特長で、AI利用の摩擦を大幅に軽減します。

🚀 クイックスタート

1. インストール

claude mcp add blockrun npx @blockrun/mcp

ウォレットが自動的に作成されます。

2. ウォレットアドレスの取得

You: blockrun setup

Claude: Your wallet address is 0x...
        Send USDC on Base network to fund it.

3. ウォレットへの資金提供

BaseネットワークでウォレットアドレスにUSDCを送金します。たった5ドルで何百ものリクエストが可能です。

4. 使用開始

自然な質問をしましょう。

You: blockrun ask GPT - 5 to explain quantum computing

You: blockrun chat with Claude Opus about this error

You: blockrun generate an image of a mountain sunset

✨ 主な機能

• ゼロAPIキー：OpenAIやGoogleなどのアカウント不要で利用可能です。
• 1つのウォレット：すべてのプロバイダーに対して単一のUSDC残高を持つ統一ウォレットを使用します。
• 従量制課金：最低利用料がなく、5ドルから利用を開始できます。
• 1つのコマンド：インストール後すぐに利用できます。

💻 使用例

基本的な使用法

任意のモデルとチャット

blockrun ask GPT - 5 what causes aurora borealis

blockrun chat with Claude Opus about optimizing this algorithm

blockrun ask Gemini Pro to review this code for security issues

人気のモデル:

• openai/gpt - 5.2 - OpenAIの最強モデル
• anthropic/claude - opus - 4 - 複雑な推論に最適
• anthropic/claude - sonnet - 4 - 高速かつ高性能（推奨）
• google/gemini - 2.5 - pro - 長文のコンテキストに適しています（1Mトークン）
• deepseek/deepseek - chat - 非常に安価

スマートモデル選択

blockrun smart fast: what's 2+2

blockrun smart powerful: analyze this complex codebase

blockrun smart cheap: summarize this text

画像生成

blockrun generate an image of a cyberpunk cityscape

blockrun create a watercolor painting of mountains

利用可能なモデルの一覧表示

blockrun list models

blockrun show OpenAI models with pricing

リアルタイムX/Twitter検索

blockrun twitter: what is @elonmusk posting about today

blockrun twitter: trending AI news

blockrun twitter: reactions to [recent event]

ウォレットと残高

blockrun setup          # 初回セットアップの指示
blockrun wallet         # ウォレットアドレスを確認
blockrun balance        # オンチェーンのUSDC残高を確認

予算管理

blockrun budget check              # 現在の支出を確認
blockrun budget set $1.00          # 1ドルの制限を設定
blockrun budget clear              # 制限を解除

📚 ドキュメント

サポートされるモデルと価格

チャットモデル

M = 100万トークン。価格はUSDです。

画像モデル

コスト例

5ドルでおおよそ以下の利用が可能です:

• Gemini Flashのリクエスト50,000回、または
• Claude Sonnetのリクエスト1,600回、または
• GPT - 4oのリクエスト1,000回、または
• DALL - E 3の画像125枚

ウォレット管理

自動生成されるウォレット

BlockRun MCPを初めて使用すると、ウォレットが自動的に作成され、以下の場所に保存されます。

~/.blockrun/.session

このウォレットは:

• ローカルマシン上で作成されます。
• サーバーに送信されることはありません。
• 支払い承認の署名にのみ使用されます。
• セッションをまたいで保持されます。

独自のウォレットを使用する場合

# オプション1: 環境変数
export BLOCKRUN_WALLET_KEY=0x...

# オプション2: Claude Codeで追加
claude mcp add blockrun npx @blockrun/mcp --env BLOCKRUN_WALLET_KEY=0x...

ウォレットの優先順位

1. 環境変数 BLOCKRUN_WALLET_KEY
2. 環境変数 BASE_CHAIN_WALLET_KEY
3. ~/.blockrun/.session のファイル
4. 新しいウォレットを自動生成（ファイルに保存）

支払いの仕組み

┌─────────────────────────────────────────────────────────────┐
│  1. リクエストを送信する（例: GPT - 5とチャット）           │
│                          ↓                                  │
│  2. BlockRunがトークンに基づいてコストを計算する            │
│                          ↓                                  │
│  3. ウォレットが支払い承認をローカルで署名する              │
│     （秘密鍵は決してマシンを離れません）                    │
│                          ↓                                  │
│  4. 支払いがBaseネットワークでUSDCを通じて決済される        │
│                          ↓                                  │
│  5. AIのレスポンスを受け取る                              │
└─────────────────────────────────────────────────────────────┘

セキュリティ保証:

• 秘密鍵はローカルでの署名にのみ使用されます。
• 鍵は決してサーバーに送信されません。
• MetaMaskのトランザクションと同じセキュリティモデルです。
• すべてのトランザクションを Basescan で確認できます。

他のソリューションとの比較

claude - code - proxyとの比較

gemini - mcpとの比較

直接APIキーを使用する場合との比較

トラブルシューティング

"Payment was rejected"

ウォレットに資金が必要です。blockrun setup と入力して、アドレスと資金提供の指示を取得してください。

"Wallet key required"

MCPがウォレットを見つけられないか、作成できませんでした。~/.blockrun/ ディレクトリが書き込み可能であることを確認してください。

モデルが応答しない

一部のモデルにはレート制限があります。blockrun smart cheap または blockrun smart fast を試して、代替モデルを使用してください。

ウォレット残高を確認する

blockrun balance と入力して、オンチェーンのUSDC残高を確認するか、https://basescan.org/address/YOUR_ADDRESS にアクセスしてください。

予算制限に達した

セッション予算を設定して制限に達した場合は、blockrun budget clear で制限を解除するか、blockrun budget set $X で制限を増やしてください。

設定

Claude Codeのセットアップ

# 基本設定（推奨）
claude mcp add blockrun npx @blockrun/mcp

# 明示的なウォレットを使用する場合
claude mcp add blockrun npx @blockrun/mcp --env BLOCKRUN_WALLET_KEY=0x...

# プロジェクト固有の設定
claude mcp add blockrun --scope project npx @blockrun/mcp

# ユーザー全体（すべてのプロジェクト）の設定
claude mcp add blockrun --scope user npx @blockrun/mcp

環境変数

開発

# クローン
git clone https://github.com/blockrunai/blockrun-mcp
cd blockrun-mcp

# 依存関係のインストール
npm install

# 開発モード（自動リロード）
npm run dev

# 本番用のビルド
npm run build

# ローカルでのテスト
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node dist/index.js

リンク

• ウェブサイト: blockrun.ai
• ドキュメント: GitHub Docs
• 価格表: blockrun.ai/pricing
• GitHub: github.com/blockrunai
• Twitter: @BlockRunAI

サポート

• 問題報告: GitHub Issues
• Telegram: Join our Telegram
• メール: hello@blockrun.ai

📄 ライセンス

MIT