Nodit MCP Server

Nodit MCP サーバー

AI エージェントと開発者を、NoditのWeb3インフラストラクチャを通じて複数のネットワークにわたる、構造化されたコンテキスト対応のブロックチェーンデータに接続するModel Context Protocol（MCP）サーバーです。

概要

Nodit MCP サーバーは、AIモデルやアプリケーションがブロックチェーンエコシステムとやり取りする方法を簡素化します。
複雑なノードRPC、未加工のイベントログ、チェーン固有のデータ構造を処理する代わりに、開発者はAIの推論や意思決定に最適化された形式で、正規化されたマルチチェーンのブロックチェーンデータにアクセスできます。

NoditのMCPを使うと、次のことができます。

• EVM互換ネットワークと非EVMネットワークにわたるリアルタイムのブロックチェーンデータを照会、分析、活用するAI エージェントを構築できます。
• 専門的なブロックチェーン開発の知識がなくても、Web3統合アプリケーションを開発できます。
• 統合されたアクセスレイヤーを通じて、Noditの信頼性の高いノードインフラストラクチャ、Web3 Data API、GraphQLインデックスサービスを活用できます。
• ワークフローのニーズに応じて、ローカルとリモートの両方の統合でブロックチェーンMCPを簡単に利用できます。

対応ネットワークには、Ethereum、Base、Optimism、Arbitrum、Polygon、Aptos、Bitcoin、Dogecoin、TRON、XRPL、GIWA(Sepolia)などがあります。

目次

• ツール一覧
• 機能
• 前提条件
• ローカルのNodit MCP サーバーを実行する
• NoditリモートMCP サーバーを統合する
• トラブルシューティング
• Nodit MCPでのプロンプト例
• 対象範囲と制限事項
• ライセンス

ツール一覧

Nodit MCP サーバーは、AI エージェントがNoditのWeb3 APIとデータインフラストラクチャを動的に発見、理解し、操作するためのツールを提供します。ツールはAPIとのやり取りを個別のステップにモジュール化し、トークン消費を抑えながらコンテキストを軽量に保ちます。

• APIカテゴリ一覧のツール
  利用可能な上位レベルのAPIカテゴリ一覧を取得します。

  • list_nodit_api_categories

• API操作一覧のツール
  選択したカテゴリ（Node API、Data API、Aptos Indexer API、Webhook API、Multichain API）で利用可能な操作を取得します。

  • list_nodit_node_apis
  • list_nodit_data_apis
  • list_nodit_aptos_indexer_api_query_root
  • list_nodit_webhook_apis
  • list_nodit_multichain_apis

• API仕様取得のツール
  特定のAPI操作に関する詳細情報（パラメーター、リクエスト／レスポンスのスキーマ）を取得します。

  • get_nodit_api_spec
  • get_nodit_aptos_indexer_api_spec

• API呼び出しのツール
  operationIdと検証済みパラメーターを使用してAPI呼び出しを実行します。

  • call_nodit_api
  • call_nodit_aptos_indexer_api
  • call_nodit_multichain_api

Nodit MCP サーバーは、Model Context Protocol（MCP）の規約に従い、標準のJSON-RPC over stdioプロトコルで通信します。 現在、サーバーとクライアント間の通信ではstdioベースの通信のみがサポートされています。

機能

以下は、AI エージェントと LLM 向けに Nodit MCP Server が提供する主な機能とサポート対象のブロックチェーンネットワークです。
API の詳細な仕様と使用方法については、Nodit Developer Documentation をご覧ください。

• RPC ノードとノード API
  Nodit の専門チームが運用するインフラストラクチャを通じて、ブロックチェーンノードのエンドポイントにアクセスできます。
  リアルタイムのネットワーククエリ、トランザクションの送信、スマートコントラクトとのやり取りなどに対応しています。

• Web3 データ API
  綿密にインデックス化されたブロックチェーンデータにアクセスするための高レベル API です。
  ブロックやトランザクションの詳細、トークンの送金履歴、アカウント単位のトランザクション概要、資産の移動の詳細など、raw RPC 呼び出しだけでは直接まとめることが難しい、処理済みのデータセットを提供します。

• GraphQL インデクサー API（Aptos のみ）
  GraphQL エンドポイントを通じて、Aptos ブロックチェーンの詳細なアクティビティをクエリできます。

• サポート対象ネットワーク

  • EVM 互換：Ethereum、Arbitrum、Avalanche、Base、Chiliz、Kaia、Optimism、Polygon、BNB Chain、GIWA(Sepolia)
  • 非 EVM：Aptos、Bitcoin、Dogecoin、TRON、XRPL、Sui、Solana

前提条件

• Node.js 18+
• Nodit API Key（Nodit Console で登録して API キーを取得してください）

Nodit MCP Server をローカルで実行する

npx を使用（推奨）

npx @noditlabs/nodit-mcp-server@latest

ローカルビルドを使用

# Clone the repository
git clone --recurse-submodules https://github.com/noditlabs/nodit-mcp-server.git

# Move into the project directory
cd nodit-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

起動する前に、Nodit API キーを設定してください。

export NODIT_API_KEY=your-api-key

次に、サーバーを起動します。

node build/index.js

ローカルサーバーとの通信

Nodit MCP Server をローカルで実行すると、stdio 経由の JSON-RPC を使用して通信できます。
サーバーに基本的なリクエストを送信する方法は次のとおりです。

例：利用可能なツールを一覧表示する

JSON-RPC ペイロードを直接入力できます。

{"method":"tools/list","params":{},"jsonrpc":"2.0","id":1}

または、echo コマンドを使ってリクエストをパイプで渡すこともできます。

echo '{"method":"tools/list","params":{},"jsonrpc":"2.0","id":1}' | node build/index.js

例：特定のツールを呼び出す（list_nodit_api_categories）

echo '{"method":"tools/call","params":{"name":"list_nodit_api_categories","arguments":{}},"jsonrpc":"2.0","id":1}' | node build/index.js

Cursor IDE または Claude Desktop への接続

以下の設定を .cursor/mcp.json または claude_desktop_config.json に追加してください。

• Cursor

  • MacOS：~/.cursor/mcp.json
  • Windows：C:\Users\<Username>\.cursor\mcp.json

• Claude Desktop

  • MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows：C:\Users\<Username>\AppData\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "nodit": {
      "command": "npx",
      "args": ["@noditlabs/nodit-mcp-server@latest"],
      "env": {
        "NODIT_API_KEY": "****"
      }
    }
  }
}

🔔 重要
**** を実際の Nodit API キーに置き換えてください。
API キーが正しく設定されていない場合、認証エラーにより API リクエストが失敗します。

Claude CLI への接続

手早くセットアップするには、Nodit MCP Server を Claude CLI で直接使用することもできます。

以下のコマンドで Nodit MCP Server を追加してください。

# Add the Nodit MCP server
claude mcp add nodit-mcp-server npx @noditlabs/nodit-mcp-server

# Set API Key
export NODIT_API_KEY=your-api-key

# Start Claude with the Nodit MCP server enabled
claude

Nodit リモート MCP Server の統合

リモート MCP 統合に対応した AI ツールを使用している場合、ローカル MCP サーバーを実行せずに Nodit のリモート MCP Server に接続できます。 これにより、AI 環境内で Nodit MCP の機能を直接使用できます。

エンドポイント

以下のエンドポイントを使用して Nodit リモート MCP Server に接続してください。INSERT_YOUR_API_KEY を実際の Nodit API Key に置き換えてください。

https://mcp.nodit.io/sse?apiKey=INSERT_YOUR_API_KEY

Claude（Web）への接続

Claude Enterprise、Pro、または Max プランをご利用の場合、リモート MCP Server を統合できます。

1. Settings > Integrations に移動し、[Add custom integration] ボタンをクリックします。
2. [Add more] ボタンをクリックして、新しいリモート MCP を統合します。
3. 上記のエンドポイントを入力してセットアップを完了します。

統合が完了すると、Claude のメイン画面の Search and Tools セクションに Nodit MCP が追加されたことを確認できます。

Cursor IDE への接続

Nodit MCP を Cursor IDE に接続するには、次の手順に従います。 1. Preferences > Cursor Settings > MCP Tools を開きます。 2. [+ New MCP Server] をクリックして、mcp.json 設定ファイルを開きます。

mcp.json ファイルを次のパスから直接開いて編集することもできます。

• MacOS：~/.cursor/mcp.json
• Windows：C:\Users\<Username>\.cursor\mcp.json

以下の設定を mcpServers オブジェクトに追加します。すでにほかの MCP サーバーを設定している場合は、各エントリーをコンマで区切ります。

{
  "mcpServers": {
    "nodit": {
      "url": "https://mcp.nodit.io/sse?apiKey=INSERT_YOUR_API_KEY"
    }
  }
}

追加したら、Cursor のインターフェースで MCP Tools に戻り、nodit MCP のトグルをオンにして有効にします。ステータスが緑色で「9 tools enabled」と表示されたら、接続は完了です。

トラブルシューティング

Claude Desktop で npx 経由の MCP の実行に関する問題

Claude Desktop や、ローカルの Node.js インストールに依存するほかのツールと組み合わせて MCP サーバーを実行すると、次のような理由で問題が発生することがあります。

• 複数のバージョンの Node.js がインストールされている（例：Homebrew とパッケージインストーラー経由）
• PATH 環境の競合
• Claude Desktop が正しい Node.js ランタイムを認識しない

以下の手順に従って、Node.js 18+ がシステムに正しくインストールされ、認識されていることを確認してください。

1. 現在アクティブな Node.js のバージョンを確認する

ターミナルで次のコマンドを実行し、バージョンを確認します。

node --version

v18 以上で始まるバージョン番号（例：v18.19.0）が表示されます。

表示されない場合は、互換性のあるバージョンをインストールするか、切り替える必要があります。

ヒント

Claude Desktop は、ターミナルと同じバージョンの Node.js を使用しないことがあります。複数の方法（例：Homebrew、nvm、直接インストーラー）でインストールしている場合、想定外のバージョンがデフォルトで選択されることがあります。 一般的なインストールパスを一覧表示するには、次のコマンドを実行します。

# Homebrew installation
ls /usr/local/bin/node
ls /opt/homebrew/bin/node

# nvm installations
ls ~/.nvm/versions/node/

# System installation
ls /usr/bin/node

2. 必要に応じて Node.js 18+ をインストールするか、切り替える

互換性のあるバージョンがない場合は、次のいずれかの方法で Node.js をインストールします。

• Node.js 公式インストーラーを使用する：nodejs.org からダウンロードします
• Homebrew を使用する（macOS）：

bashbrew install node@20

• nvm を使用する（バージョン管理におすすめ）：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20
nvm use 20
nvm alias default 20

3. Claude Desktop が使用する Node.js のバージョンを確認する

Claude Desktop は、システム環境から PATH を継承します。 ターミナルで次のコマンドを実行します。

which node

これにより、現在ターミナルでアクティブな Node.js バイナリのパスが表示されます。ターミナルから起動した場合、Claude はこのパスを使用する可能性が高いです。

4. Claude Desktop が正しい Node.js バージョンを使用するようにする

• nvm を使用している場合：

nvm use 18  # Set proper version 
nvm alias default 18

• Homebrew を使用している場合は、PATH で優先されるようにします。

export PATH="/opt/homebrew/bin:$PATH"  # for Apple Silicon
# or
export PATH="/usr/local/bin:$PATH"     # for Intel Macs

バージョンの競合を避けるため、インストール方法は1つ（例：nvm または Homebrew のいずれか）に統一することをおすすめします。

5. Claude Desktop を再起動する

変更を加えた後、Claude Desktop を再起動して、正しい環境変数と Node.js のバージョンが反映されるようにします。

Nodit MCP を使ったプロンプト例

Nodit MCP に接続すると、自然言語を使って複数のネットワークのブロックチェーンデータを直接照会できます。 以下の例は、数ある可能性のほんの一部です。ぜひさらに試して、独自のユースケースを探ってみてください。

📊 オンチェーンアクティビティのモニタリング

Summarize the recent activity of 0xabc…def across Ethereum and Arbitrum. Include major transactions, token transfers, and NFT interactions over the past 7 days.

What fungible and non-fungible tokens does this wallet hold across Ethereum and Polygon? Include balances and token names.

Analyze the risk profile of wallet 0xabc… based on its recent on-chain behavior.

🧾 スマートコントラクトとトランザクションの分析

Analyze how users interacted with the contract at 0xcontract… on Ethereum over the last week.

Analyze the last 10 blocks on Arbitrum.

🧠 AI エージェントのユースケース

Based on wallet 0xabc…’s holdings, recommend optimal DeFi strategies across Ethereum and Arbitrum.

Create a daily summary report for 0xdao… including token balances, inflow/outflow, and governance activity.

⚙️ Web3 DApp の開発

Write TypeScript code using fetch to retrieve all ERC-20 transfers for 0xabc… from Ethereum using Nodit’s Node API.

Build a simple dashboard to visualize how assets have moved in recent XRPL transactions.

Build a dashboard that aggregates blockchain data across multiple chains using Nodit.

範囲と制限事項

Nodit MCP Server は、LLM ベースのエージェントが Nodit の API を効果的に利用できるよう、構造化されたコンテキストを提供します。
その役割には、以下が含まれます。

• Nodit の API（Node API、Web3 Data API）を LLM が利用できる形式に構造化します。
• エンドポイントの詳細、入出力スキーマ、応答のサンプル、エラー処理のガイドラインを提示します。

ただし、以下は MCP の制御範囲外です。

• API の選択は、LLM のバージョン（GPT-4、Claude 3 など）、プロンプトエンジニアリング、またはエージェントの設計によって異なる場合があります。
• API の応答やエラーの解釈は、利用する LLM の推論能力に依存します。

Nodit MCP Server は、正確で構造化された API コンテキストの提供に注力しますが、
外部 LLM の最終的な推論結果や動作を 保証するものではありません。

ライセンス

このプロジェクトは、Apache License 2.0 の下でライセンスされています。
ライセンス条項の全文については、LICENSE ファイルを参照してください。
関連する法的通知は、NOTICE ファイルに記載されています。

「Nodit」および Nodit のロゴは、Lambda256 の商標です。
事前の書面による許可なく、名称またはロゴを使用することは禁止されています。

---

© Lambda256. All rights reserved.