Linea MCP Server

Linea MCP サーバー

AI アプリケーションが Linea ブロックチェーンと連携するためのオンチェーンツールを提供する、Model Context Protocol（MCP）サーバーです。

概要

Linea-MCP は、ゼロ知識証明技術を使用する Ethereum Layer 2 スケーリングソリューションである Linea ブロックチェーンと連携するツールを提供し、あらゆる MCP クライアントの機能を拡張します。このサーバーを使用すると、Claude、Cursor、その他の MCP 対応クライアントなどの AI アシスタントが、自然言語によるリクエストでブロックチェーン操作を実行できます。

主な機能

• ウォレット管理：アドレスの取得と残高の確認
• トークン操作：ERC20 トークンの送金、残高の確認、トークン一覧の表示
• スマートコントラクト連携：コントラクトのデプロイと呼び出し
• NFT 管理：NFT の一覧表示と送金
• ブリッジ操作：Ethereum と Linea 間でのアセットのブリッジ
• DeFi 連携：DeFi プロトコルとの連携
• Verax 連携：Linea Verax アテステーションによる本人確認
• Linea ENS：Linea ENS 名の解決と管理

詳しい使用例については、examples.md を参照してください。

クイックスタート

前提条件

• Node.js（v16 以降）
• npm または yarn
• Linea RPC エンドポイントへのアクセス

インストール方法

方法 1：クイックインストール（グローバルパッケージ）

# Install globally
npm install -g linea-mcp

# Create a basic .env file
echo "LINEA_MAINNET_RPC_URL=https://rpc.linea.build
LINEA_TESTNET_RPC_URL=https://rpc.sepolia.linea.build
WALLET_PRIVATE_KEY=your_wallet_private_key_here
INFURA_API_KEY=your_infura_key_here" > .env

# Start the server
linea-mcp

方法 2：開発用インストール（ソースから）

# Clone the repository
git clone https://github.com/qvkare/linea-mcp.git
cd linea-mcp

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your configuration

# Build and start
npm run build
node dist/index.js  # Using Node directly is more reliable than npm start

MCP クライアントとの連携

この MCP サーバーは、Cursor、Claude Desktop、Windsurf、Cline、その他の AI アシスタントを含む、あらゆる MCP 対応クライアントと連携できます。

一般的な設定手順

1. クライアントの MCP 設定ファイルの場所を確認します
2. Linea MCP サーバーの設定セクションを追加します
3. 次のいずれかの方法でサーバーを設定します

方法 1：グローバルインストールを使用（簡単）

{
  "mcpServers": {
    "linea": {
      "command": "npx",
      "args": ["linea-mcp@latest"],
      "env": {
        "PORT": "3000",
        "LINEA_MAINNET_RPC_URL": "https://rpc.linea.build",
        "LINEA_TESTNET_RPC_URL": "https://rpc.sepolia.linea.build",
        "INFURA_API_KEY": "your_infura_key",
        "ALCHEMY_API_KEY": "your_alchemy_key",
        "PRIVATE_KEY_ENCRYPTION_KEY": "your_encryption_key_please_change",
        "WALLET_PRIVATE_KEY": "your_wallet_private_key_or_mnemonic",
        "NODE_ENV": "development",
        "ETHEREUM_RPC_URL": "https://mainnet.infura.io/v3/your_infura_key",
        "ETHEREUM_TESTNET_RPC_URL": "https://sepolia.infura.io/v3/your_infura_key"
      }
    }
  }
}

方法 2：ローカルインストールを使用（開発におすすめ）

{
  "mcpServers": {
    "linea": {
      "command": "node",
      "args": ["/absolute/path/to/linea-mcp/dist/index.js"],
      "cwd": "/absolute/path/to/linea-mcp",
      "env": {
        // Same environment variables as Option 1
        "PORT": "3000",
        "LINEA_MAINNET_RPC_URL": "https://rpc.linea.build",
        // ... other variables from Option 1
      }
    }
  }
}

重要な注意事項：ローカルインストールを使用する場合は、npm スクリプトを使うより、Node.js で JavaScript ファイルを直接実行するほうが、より安定した通信が得られます。

クライアントごとの設定ファイルの場所

• Cursor：

  • Windows：%APPDATA%\Cursor\mcp.json
  • macOS：~/Library/Application Support/Cursor/mcp.json
  • Linux：~/.config/Cursor/mcp.json

• Claude Desktop：

  • Windows：%APPDATA%\Claude\claude_desktop_config.json
  • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux：~/.config/Claude/claude_desktop_config.json

• その他のクライアント：MCP 設定ファイルの場所については、各クライアントのドキュメントを参照してください

トラブルシューティング

よくある問題

1. 「利用可能なツールがありません」または「クライアントが終了しました」というエラー：

   • npm スクリプトではなく、Node.js で直接実行してください（"command": "node", "args": ["/path/to/dist/index.js"]）
   • 環境変数が正しく設定されていることを確認してください
   • 設定を変更した後は、クライアントを再起動してください

2. ログに JSON 解析エラーが表示される：

   • 通信プロトコルに問題があることを示しています
   • Node.js で直接実行すると、通常はこの問題を解決できます
   • cwd プロパティが正しく設定されていることを確認してください

3. トラブルシューティングの完全ガイド：

   • よくある問題への詳しい解決方法については、docs/troubleshooting.md を参照してください

利用可能なツール

サーバーは、複数のカテゴリにわたるツールを提供します。

• ウォレット：アドレス管理、残高確認、資金の送金
• トークン：ERC20 の送金、残高確認、トークン情報
• コントラクト：デプロイと操作
• NFT：一覧表示と送金
• ブリッジ：Ethereum と Linea 間の資産ブリッジ
• DeFi：流動性プール、トークンスワップ、イールドファーミング
• ENS：名前解決とレコード管理
• Verax：アイデンティティ認証

ツールの一覧と使用方法については、docs/tools.md を参照してください。

セキュリティに関する考慮事項

• 秘密鍵やシードフレーズは決して共有しないでください
• 機密性の高い設定には環境変数を使用してください
• メインネットで使用する前に、テストネットで十分にテストしてください

ライセンス

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