Arbitrum MCP Tools 🚀🦾

Arbitrum MCP ツール 🚀🦾

このプロジェクトは、Model Context Protocol（MCP）を介して Arbitrum ブロックチェーンとやり取りするためのツールセットを提供し、Claude Desktop、Claude Code、Cursor、Windsurf、VS Code、Gemini CLI、Antigravity、OpenAI Codex などの AI アシスタントがブロックチェーン操作を実行できるようにします。

⚠️ 重要：セキュリティと責任に関する注意

このツールキットを使用すると、AI アシスタントがあなたに代わってブロックチェーンデータの読み取りやオンチェーン操作の実行（コントラクトのデプロイ、トランザクションのシミュレーションなど）を行えるようになります。これらのツールを使用することで、ツールを通じて実行されるすべての操作に対する全責任を負うことに同意したものとみなされます。

• 確定する前に、AI が提案した操作を必ず確認してください。 AI アシスタントは意図を誤解したり、予期しない結果を生み出したりすることがあります。
• 秘密鍵や API キーは決して共有しないでください。 機密性の高い認証情報（STYLUS_PRIVATE_KEY、ALCHEMY_API_KEY など）を含む環境変数は、パスワードと同じように慎重に扱ってください。
• まずテストネットを使用してください。 Arbitrum メインネットでオンチェーン操作を行う前に、Arbitrum Sepolia でテストし、期待どおりに動作することを確認してください。
• 承認する内容を理解してください。 AI アシスタントがトランザクション、デプロイ、コントラクトとのやり取りを提案した場合は、実行を許可する前に、その内容を理解していることを確認してください。
• 本プロジェクトの作者は責任を負いません。 これらのツールの使用によって生じた金銭的損失、意図しないトランザクション、損害について、本プロジェクトの作者は責任を負いません。自己責任でご使用ください。

このソフトウェアは、いかなる種類の保証もなく「現状のまま」提供されます。オンチェーン操作は取り消しできません。十分に注意して進めてください。

目次 📚

• クイックスタート
• 前提条件
• 対応プラットフォーム
• 環境変数
• CLI コマンド
• 利用可能なツール
• 使用例
• 開発ガイド

クイックスタート 🚀

1 つのコマンドで、Arbitrum MCP Tools を AI アシスタントにインストールできます。

npx arbitrum-mcp-tools install

これにより、セットアップ手順を案内する対話型ウィザードが起動します。

前提条件 📝

• Node.js v20.x 以降
• npm（Node.js に同梱）
• Alchemy API Key（https://www.alchemy.com/ で登録）
• Arbiscan API Key（任意、https://arbiscan.io で登録）- decodeTransactionCalldata ツールに必要です

対応プラットフォーム 🖥️

Arbitrum MCP Tools は、macOS、Windows、Linux で8 つのプラットフォームに対応しています。

プラットフォーム	形式	状態
Claude Desktop	JSON	✅ 対応
Claude Code	JSON	✅ 対応
Cursor	JSON	✅ 対応
Windsurf	JSON	✅ 対応
VS Code	JSON	✅ 対応
Gemini CLI	JSON	✅ 対応
Antigravity	JSON	✅ 対応
OpenAI Codex	TOML	✅ 対応

環境変数 🔐

🔒 セキュリティのベストプラクティス：

• 可能な限り、秘密鍵は環境変数に平文で保存するのではなく、キーストアファイル（STYLUS_KEYSTORE_PATH）に保存してください。
• API キーを含む .env ファイルやシェルプロファイルは、バージョン管理に決してコミットしないでください。
• API キーは定期的にローテーションし、漏えいした可能性のあるキーはすべて無効化してください。
• 本番環境にデプロイする場合は、ハードウェアウォレットまたは専用のシークレットマネージャーの使用を検討してください。

シェルプロファイル（~/.zshrc または ~/.bashrc）に次の環境変数を設定してください。

# Required
export ALCHEMY_API_KEY="your_alchemy_api_key_here"

# Optional (for transaction decoding)
export ARBISCAN_API_KEY="your_arbiscan_api_key_here"

# Stylus Contract Authentication (choose one method)
# Option 1: Direct private key
export STYLUS_PRIVATE_KEY="your_private_key_here"

# Option 2: Path to private key file
export STYLUS_PRIVATE_KEY_PATH="/path/to/your/private/key/file"

# Option 3: Path to keystore file (most secure)
export STYLUS_KEYSTORE_PATH="/path/to/your/keystore/file"

その後、シェルを再読み込みします：source ~/.zshrc

Windows（PowerShell）

[Environment]::SetEnvironmentVariable("ALCHEMY_API_KEY", "your_key_here", "User")

CLI コマンド 🛠️

install

MCP ツールをセットアップするための対話型インストールウィザードです。

npx arbitrum-mcp-tools install

uninstall

選択したプラットフォームから MCP ツールを削除します。

npx arbitrum-mcp-tools uninstall

list

対応するすべてのプラットフォームとインストール状況を表示します。

npx arbitrum-mcp-tools list

serve

MCP サーバーを起動します（MCP クライアント内部で使用）。

npx arbitrum-mcp-tools serve

--help / --version

npx arbitrum-mcp-tools --help
npx arbitrum-mcp-tools --version

利用可能なツール 🧰

ツールは次のカテゴリーに分類されています。

1. アカウント分析 - 残高、トランザクション、トークンを確認するツール
2. チェーンデータ - ブロックやトランザクションなどのブロックチェーンデータを取得するツール
3. コントラクト操作 - スマートコントラクトを操作するツール
4. クロスチェーン - クロスチェーン操作を行うツール
5. 開発 - 開発者向けのツール（シミュレーション、ガス見積もり）
6. 一括操作 - 複数のアドレスに対して操作を行うツール
7. Stylus - Stylus の開発とデプロイに関するツール

すべてのツールの詳細な一覧については、機能一覧をご覧ください。

使用例 📝

サポートされている AI アシスタントを使う際は、自然言語でブロックチェーンデータを尋ねるだけです。

• 「0x123... の ETH 残高はいくらですか？」
• 「0xabc... が所有する NFT を確認してください」
• 「1 ETH を送金するには、どれくらいのガスが必要ですか？」
• 「Arbitrum の最新ブロックを表示してください」
• 「このトランザクションの入力データをデコードしてください：0x...」
• 「私の Stylus コントラクトを Arbitrum Sepolia にデプロイしてください」

開発ガイド 🏗️

プロジェクト構成 🗂️

src/
├── index.ts                # Entry point (runs server)
├── server.ts               # MCP server setup and Alchemy config
├── cli/                    # CLI installer
│   ├── index.ts            # CLI entry point
│   ├── commands/           # CLI commands (install, uninstall, list, serve)
│   ├── clients/            # Platform config generators
│   └── utils/              # CLI utilities
├── tools/                  # All tools organized by category
│   ├── common.ts           # Shared utilities and configs
│   ├── index.ts            # Tool registration
│   ├── accountAnalysis/    # Account analysis tools
│   ├── chainData/          # Chain data tools
│   ├── contractInteraction/# Contract interaction tools
│   ├── crossChain/         # Cross-chain tools
│   ├── development/        # Development tools
│   ├── batchOperations/    # Batch operation tools
│   └── stylus/             # Stylus development tools

新しいツールの追加 🛠️

Arbitrum MCP Tools では、アクティブな登録パターンを使用しています。各ツールは実行時に server.tool(...) で登録されます。新しいツールを追加するには、次の手順に従います。

1. 該当カテゴリーの registerXTools 関数にツールを追加します

// src/tools/myCategory/index.ts
import { z } from "zod";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

export function registerMyCategoryTools(server: McpServer) {
  server.tool(
    "myNewTool",
    "Short description of what it does",
    {
      param1: z.string().describe("Example parameter"),
    },
    async ({ param1 }) => {
      return {
        content: [{ type: "text", text: `You sent ${param1}` }],
      };
    }
  );
}

2. カテゴリーをグローバルレジストリに登録します

// src/tools/index.ts
import { registerMyCategoryTools } from "./myCategory/index.js";

export function registerAllTools(server: McpServer) {
  // …existing categories
  registerMyCategoryTools(server);
}

ツールのテスト 🧪

1. プロジェクトをビルドします。

npm run build

2. MCP サーバーを直接テストします。

node build/src/index.js

3. AI アシスタントでテストするには、プラットフォームの設定を一時的に変更し、ローカルビルドを参照するようにします。

{
  "mcpServers": {
    "arbitrum": {
      "command": "node",
      "args": ["/path/to/arbitrum-mcp-tools/build/src/index.js"]
    }
  }
}

ツールドキュメントへのリンク 🔗

• Alchemy SDK：Alchemy SDK クイックスタート
• Arbitrum Stylus：Stylus CLI の使用方法

免責事項 ⚖️

このプロジェクトは、Model Context Protocol を通じて AI アシスタントを Arbitrum ブロックチェーンに接続するオープンソースの開発者向けツールです。開発、テスト、教育目的での使用を想定しています。

重要事項：

• デプロイ、トランザクション、アクティベーションなど、すべてのオンチェーン操作は、AI アシスタントを通じてユーザーが開始します。ユーザーの操作なしにツールが何らかのアクションを実行することはありません。
• MCP サーバーはお使いのマシン上でローカルに実行され、Alchemy API および Arbitrum RPC エンドポイントとのみ通信します。これらのサービス以外のサードパーティーサーバーにデータが送信されることはありません。
• スマートコントラクトのデプロイとオンチェーントランザクションは取り消せません。確定する前に、トランザクションのパラメーター、対象ネットワーク、ガス代を必ず確認してください。
• このプロジェクトは、お客様の資金を保管、管理、または利用することはありません。秘密鍵はローカル環境に保管され、ツールによって送信または保存されることはありません。
• AI が生成する提案の正確性、安全性、信頼性について、作者は一切保証しません。すべての操作の確認と承認は、お客様ご自身の責任で行ってください。

このソフトウェアを使用することで、ブロックチェーン操作に伴うリスクを理解し、結果に対する全責任を負うことに同意したものとみなされます。

コントリビューション 🙌

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。

ライセンス 📜

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。