Rootstock MCP Server

RSK MCP サーバー - Rootstock ブロックチェーンツール

Rootstock MCP サーバーは、Rootstock（RSK）ブロックチェーンとやり取りするための高度なツールを提供する Model Context Protocol（MCP）サーバーです。このプロジェクトを使うと、AI クライアントはブロックチェーン操作にシームレスに接続して実行できます。

🚀 主な機能

• 💼 ウォレット管理：複数のウォレットを作成、インポート、切り替え、管理できます
• 💰 残高照会：rBTC および ERC20 トークンの残高を確認できます
• 💸 送金：rBTC やトークンを他のアドレスに送金できます
• 🔍 トランザクション追跡：ハッシュを使ってトランザクションのステータスを確認できます
• 🚀 コントラクトのデプロイ：Rootstock 上にスマートコントラクトをデプロイできます
• ✅ コントラクトの検証：デプロイ済みコントラクトを検証できます
• 📄 コントラクトとのやり取り：検証済みコントラクトからデータを読み取れます
• 📊 履歴：トランザクション履歴を照会できます
• 🎯 アテステーション：RAS（Rootstock Attestation Service）を使ってアテステーションを作成、検証、管理できます
• 🏗️ スキーマ管理：アテステーションスキーマを作成、管理できます
• 📝 アテステーションの照会：さまざまな条件でアテステーションを一覧表示、絞り込みできます

🧰 利用可能なツール

このサーバーは22個のMCPツールを公開します。これらを直接呼び出す必要はありません。MCPに接続すると、AIクライアントがプロンプトに基づいて適切なツールを選択します。

カテゴリ	ツール	説明
セッション	start-interaction	Rootstock CLI 関数とのやり取りを開始します
セッション	list-pending-operations	確認待ちの操作（デプロイ、送金）を一覧表示します
セッション	confirm-operation	IDを指定して、保留中の操作を確認し実行します
セッション	cancel-operation	IDを指定して、保留中の操作をキャンセルします
ウォレット	start-wallet-interaction	利用可能なウォレット管理操作を表示します
ウォレット	create-wallet	ウォレットを作成、インポート、一覧表示、切り替え、または削除します
ウォレット	use-wallet-from-creation	再アップロードせずに、以前の create-wallet の結果からウォレットデータを再利用します
残高	check-balance	rBTC または ERC20 トークンの残高を確認します
送金	transfer-tokens	ウォレット間でrBTCまたはERC20トークンを送金します
トランザクション	check-transaction	ハッシュを指定してトランザクションのステータスと詳細を確認します
トランザクション	check-transaction-history	Alchemy API を介してウォレットのトランザクション履歴を照会します
コントラクト	deploy-contract	ABI とバイトコードを使ってスマートコントラクトをデプロイします
コントラクト	verify-contract	デプロイ済みコントラクトのソースコードを検証します
コントラクト	read-contract	検証済みコントラクトの view/pure 関数を呼び出します
アテステーション	issue-attestation	RAS（Rootstock Attestation Service）を介して新しいアテステーションを発行します
アテステーション	verify-attestation	UIDを指定して既存のアテステーションを検証します
アテステーション	revoke-attestation	UIDを指定して既存のアテステーションを取り消します
アテステーション	list-attestations	イベントログでアテステーションを照会します（カスタムRPC URLが必要です）
アテステーション	create-schema	新しいアテステーションスキーマを登録します
アテステーション	attest-deployment	RAS のデフォルトスキーマを使って、コントラクトのデプロイをアテストします
アテステーション	attest-verification	RAS のデフォルトスキーマを使って、コントラクトの検証をアテストします
アテステーション	attest-transfer	RAS のデフォルトスキーマを使って、トークンの送金をアテストします

パラメーターと例については、以下の詳細な機能を参照してください。

📋 前提条件

• Node.js v18 以上
• npm または yarn
• TypeScript（開発用依存関係に含まれています）

注： この Model Context Protocol サーバーは、MCP 標準に対応した LLM クライアント（例：Cursor、Claude、Warp など）から使用します。ここでは、次の 2 つの手順が必要です。

1. インストールとビルド
2. AI クライアントの設定

クライアントで MCP を正しく使用するには、両方の設定を完了する必要があります。

🛠️ インストールとビルド

1. リポジトリをクローンする

git clone https://github.com/rsksmart/rsk-mcp-server
cd rsk-mcp-server

2. 依存関係をインストールする

npm install

3. プロジェクトをビルドする

npm run build

このコマンドは、次の処理を行います。

• TypeScript をコンパイルし、build/ フォルダーに JavaScript を出力します
• メインファイル（build/index.js）を実行可能にします

4. インストールを確認する

node build/index.js

重要： この MCP をローカルで実行する場合、ビルド後に build フォルダー内に作成される index.js ファイルをクライアントで指定します。

⚙️ AI クライアントの設定

🏠 リモート設定

Cursor IDE の場合

Cursor で、Settings > Cursor Settings > Tools & Integrations に移動します。

Add Custom MCP を選択します。

JSON ファイルに次の内容を追加します。

{
  "mcpServers": {
    "rsk-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@rsksmart/rsk-mcp-server"
      ]
    }
  }
}
// The Args field contains the path to the index.js file created by the build.

注： Cursor へのインストールについては、こちらの手順に従ってください：こちら

Cursor にインストールすると、次のように表示されます。

緑色の点は、正しくインストールされたことを示します。

Claude Desktop（Anthropic）の場合

Claude Desktop の設定ファイルを編集します。

Claude クライアントを開き、Settings/Developer をクリックします。

「Edit Config」ボタンをクリックして設定ファイルを開き、次の設定を追加します。

注： この操作では、設定ファイルが存在しない場合は新しく作成し、存在する場合は既存の設定ファイルを開きます。ファイルの場所は次のとおりです。

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

{
  "mcpServers": {
    "rsk-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@rsksmart/rsk-mcp-server"
      ]
    }
  }
}
// The Args field contains the path to the index.js file created by the build.

注： Claude へのインストールについては、こちらの手順に従ってください：こちら

この MCP を Claude クライアントにインストールすると、Web search オプションの下にある Search and tools オプションをクリックしたときに表示されます（次の画像を参照）。

🏠 ローカル設定

Cursor IDE の場合

Cursor で、Settings > Cursor Settings > Tools & Integrations に移動します。

Add Custom MCP を選択します。

JSON ファイルに次の内容を追加します。

{
  "mcpServers": {
    "rsk-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/your/project/rsk-mcp-server/build/index.js"]
    }
  }
}
// The Args field contains the path to the index.js file created by the build.

注： Cursor へのインストールについては、こちらの手順に従ってください：こちら

Cursor にインストールすると、次のように表示されます。

緑色の点は、正しくインストールされたことを示します。

Claude Desktop（Anthropic）の場合

Claude Desktop の設定ファイルを編集します。

Claude クライアントを開き、［Settings／Developer］をクリックします。

［Edit Config］ボタンをクリックして設定ファイルを開き、次の設定を追加します。

注： この操作では、設定ファイルが存在しない場合は新しいファイルが作成され、存在する場合は既存の設定ファイルが開きます。ファイルの場所は次のとおりです。

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

{
  "mcpServers": {
    "rsk-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/your/project/rsk-mcp-server/build/index.js"],
      "env": {}
    }
  }
}
// The Args field contains the path to the index.js file created by the build.

注： Claude のインストール方法については、こちらの手順に従ってください［こちら］(https://modelcontextprotocol.io/quickstart/user)

この MCP を Claude クライアントにインストールすると、次の画像のように、［Web search］オプションの下にある Search and tools オプションをクリックしたときに表示されます。

その他の MCP 実装の場合

MCP 互換クライアントであれば、次の方法で接続できます。

node /path/to/project/rsk-mcp-server/build/index.js

🌐 リモート設定（URL）

注： この機能は、サーバーがパブリックエンドポイントにデプロイされた後に利用可能になります。

リモートクライアントの設定

{
  "mcpServers": {
    "rsk-mcp": {
      "url": "https://your-server.com/mcp-endpoint",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

🔧 詳細な機能

この MCP をクライアントにインストールすると、チャットボックスでプロンプトを入力して操作できます。たとえば、この MCP とのやり取りを始めるには、次のようなプロンプトを入力します。 I would like to start interacting with Rootstock

すると、MCP ツールの使用許可を求められます。［Accept］をクリックすると、次のような応答が返されます。

Perfect! The Rootstock CLI is now active and ready to help you interact with the Rootstock blockchain. Here are the available options:
Available Rootstock Operations:
💼 wallet - Manage your wallet (create new, use existing, or import)
💰 balance - Check wallet balances
💸 transfer - Transfer RBTC or ERC20 tokens
🔍 tx - Check transaction status
🚀 deploy - Deploy a smart contract
✅ verify - Verify a contract
📄 contract - Interact with a contract
📊 history - Check transaction history
❓ help - Display help
What would you like to do? If you don't have a wallet yet, I'd recommend starting with option 1 (wallet management) to create or import a wallet first. Then you can proceed with other operations like checking balances, transferring tokens, or deploying contracts.
Which option interests you?

必要な操作に応じて、このワークフローを続けることができます。

1. 🧭 セッションと対話

利用可能なツール：

• start-interaction：開始ツールです。ユーザーが初めて Rootstock について尋ねたときは、ここから始めます。利用可能なすべての操作を一覧表示します。
• list-pending-operations：確認待ちの操作（コントラクトのデプロイ、トークンの送金）を一覧表示します。
• confirm-operation：操作 ID を使って、保留中の操作を確認して実行します。
• cancel-operation：操作 ID を使って、保留中の操作をキャンセルして破棄します。

確認が必要な理由： deploy-contract や transfer-tokens のような重要な操作では、呼び出しごとに confirmAction のブール値が必要です。これを省略すると、スキーマ検証に失敗します。confirmAction: false を渡すと、操作は実行されずに保留中となり（5 分後に期限切れになります）、confirm-operation で確認されるまでオンチェーンでは何も実行されません。最初の呼び出しで confirmAction: true を渡すと、この保留ステップが完全にスキップされます。ツールの説明では、実際の人が明示的に承認するまでは AI エージェントがこれを行わないよう指示しています。そのため、これをデフォルトのワークフローではなく、すでに承認済みの自動化で使うための例外的な手段として扱ってください。

保留中の操作を一覧表示

{} // no parameters

操作を確認

{
  operationId: "op_1700000000000_abc123xyz" // ID returned when the operation was created
}

操作をキャンセル

{
  operationId: "op_1700000000000_abc123xyz"
}

2. 💼 ウォレット管理

利用可能なツール：

• start-wallet-interaction：ウォレット管理を初期化します。
• create-wallet：ウォレットを作成、インポート、管理します。
• use-wallet-from-creation：以前の create-wallet の結果に含まれるウォレットデータを再アップロードせずに再利用します。

対応する操作：

🆕 新しいウォレットを作成

// Creates a wallet with secure password
{
  walletOption: "🆕 Create a new wallet",
  walletName: "MyWallet",
  walletPassword: "secure_password",
  replaceCurrentWallet: false
}

🔑 既存のウォレットをインポート

// Import using private key
{
  walletOption: "🔑 Import existing wallet",
  walletName: "ImportedWallet",
  privateKey: "0x...",
  walletPassword: "secure_password"
}

🔍 保存済みのウォレットを一覧表示

// List all available wallets
{
  walletOption: "🔍 List saved wallets",
  walletData: "my-wallets.json_content"
}

🔁 アクティブなウォレットを切り替え

// Switch to another wallet
{
  walletOption: "🔁 Switch wallet", 
  newMainWallet: "WalletName"
}

♻️ 前回作成したウォレットを再利用

// Skips re-uploading wallet data by referencing the create-wallet result
{
  testnet: true,
  token: "rBTC",
  walletCreationResult: "{\"walletsData\":{...}}" // the full JSON string returned by create-wallet, not a parsed object
}

3. 💰 残高の照会

ツール：check-balance

対応トークン：

• rBTC - Rootstock のネイティブトークン
• USDT - Tether USD
• DOC - Dollar on Chain
• BPRO - BitPro
• RIF - RIF Token
• FISH - Fish Token
• カスタムトークン - 任意の ERC20 トークン

例：

{
  testnet: true, // true for testnet, false for mainnet
  token: "rBTC",
  walletName: "MyWallet" // optional, uses current wallet if not specified
}

カスタムトークンの場合：

{
  testnet: true,
  token: "Custom Token",
  customTokenAddress: "0x...", // token contract address
  walletName: "MyWallet"
}

4. 💸 トークンの送金

ツール：transfer-tokens

ウォレット間で rBTC または ERC20 トークンを送金します。deploy-contract と同様に、すべての呼び出しで confirmAction が必須です。false を渡すと、実行前に confirm-operation で確認が必要な保留中の操作が返されます。実在する人が送金を承認した場合にのみ、true を渡してください。

要件：

• 受取人のアドレス
• 金額（文字列ではなく数値）
• 十分な残高のあるウォレット
• トークンコントラクトのアドレス（省略可能。ネイティブの rBTC の場合は省略）

例：

{
  testnet: true,
  toAddress: "0x...", // recipient address
  value: 0.01, // amount to transfer (number)
  tokenAddress: "0x...", // optional, omit for native rBTC transfers
  walletData: "my-wallets.json_content",
  walletPassword: "wallet_password",
  confirmAction: false // required on every call; false requires confirm-operation, true executes immediately
}

5. 🔍 トランザクションの追跡

ツール：check-transaction

{
  testnet: true, // network to check
  txid: "0x..." // transaction hash (with or without 0x prefix)
}

返される情報：

• トランザクションのステータス（保留中／確認済み／失敗）
• ブロック番号
• 使用されたガス
• 送金の詳細
• タイムスタンプ

6. 📊 トランザクション履歴

ツール：check-transaction-history

Alchemy API を使用して、ウォレットのトランザクション履歴を照会します。

要件：

• Alchemy API キー（省略可能。省略すると保存済みのキーが使用されます）

例：

{
  testnet: true,
  apiKey: "your-alchemy-api-key", // optional, uses a stored key if omitted
  number: "10", // number of transactions to retrieve (string)
  walletData: "my-wallets.json_content"
}

7. 🚀 コントラクトのデプロイ

ツール：deploy-contract

要件：

• コントラクト ABI（JSON）
• コンパイル済みバイトコード（16 進数）
• コンストラクターの引数（省略可能）
• 十分な残高のあるウォレット

例：

{
  testnet: true,
  abiContent: `[{"inputs":[],"name":"myFunction"...}]`, // complete ABI
  bytecodeContent: "0x608060405234801561001057600080fd5b50...", // bytecode
  constructorArgs: ["arg1", "arg2"], // constructor arguments
  walletData: "my-wallets.json_content",
  walletPassword: "wallet_password"
}

8. ✅ コントラクトの検証

ツール：verify-contract

要件：

• デプロイ済みコントラクトのアドレス
• Solidity ソースコード
• コンパイルメタデータ（JSON Standard Input）
• 使用したコンストラクターの引数

例：

{
  testnet: true,
  contractAddress: "0x...", // contract address
  contractName: "MyContract", // exact name in source code
  jsonContent: `{"language":"Solidity","sources":{...}}`, // compilation metadata
  constructorArgs: ["arg1", "arg2"] // arguments used in deployment
}

9. 📄 コントラクトの読み取り

ツール：read-contract

利用可能な関数を一覧表示するには：

{
  testnet: true,
  contractAddress: "0x..." // must be a verified contract
}

関数を呼び出すには：

{
  testnet: true,
  contractAddress: "0x...",
  functionName: "balanceOf", // view/pure function name
  functionArgs: ["0x..."] // function arguments
}

10. 🌐 対応ネットワーク

Rootstock メインネット

• RPC URL： https://public-node.rsk.co
• チェーン ID： 30
• エクスプローラー： https://explorer.rootstock.io

Rootstock テストネット

• RPC URL： https://public-node.testnet.rsk.co
• チェーン ID： 31
• エクスプローラー： https://explorer.testnet.rootstock.io

11. 🎯 アテステーション管理

利用可能なアテステーションツール：

• issue-attestation：生のスキーマとエンコード済みデータを使用して新しいアテステーションを作成します
• verify-attestation：UID を指定して既存のアテステーションを検証します
• revoke-attestation：アテステーションを取り消します
• list-attestations：イベントログでアテステーションを照会します（カスタム RPC URL が必要です）
• create-schema：新しいアテステーションスキーマを登録します
• attest-deployment：RAS のデフォルトスキーマを使用してデプロイメントアテステーションを作成します
• attest-verification：RAS のデフォルトスキーマを使用してコントラクト検証アテステーションを作成します
• attest-transfer：RAS のデフォルトスキーマを使用して送金アテステーションを作成します

🎯 アテステーションの発行

{
  testnet: true,
  recipient: "0x...", // recipient address
  schema: "0x...", // schema UID
  data: "encoded_data", // schema-encoded data
  expirationTime: 0, // optional timestamp
  revocable: true // optional
}

🔍 アテステーションの検証

{
  testnet: true,
  uid: "0x..." // attestation UID
}

❌ アテステーションの取り消し

{
  testnet: true,
  uid: "0x...", // attestation UID
  walletData: {}, // wallet configuration
  walletPassword: "password"
}

📋 アテステーションの一覧表示

注： RSK のパブリックノードは eth_getLogs をサポートしていません。Alchemy や GetBlock などのプロバイダーが提供するカスタム rpcUrl が必要です。

{
  testnet: true,
  rpcUrl: "https://rsk-mainnet.g.alchemy.com/v2/YOUR_KEY", // required
  recipient: "0x...", // optional filter
  attester: "0x...", // optional filter
  schema: "0x...", // optional filter
  limit: 10 // optional, default 10
}

🏗️ スキーマの作成

{
  testnet: true,
  schema: "uint256 tokenId, string name", // schema definition
  revocable: true,
  resolverAddress: "0x...", // optional, defaults to zero address
  walletData: {}, // wallet configuration
  walletPassword: "password"
}

🏗️ デプロイメントのアテステーション

RAS のデフォルトのデプロイメントスキーマを使用して、デプロイメントアテステーションを作成します。schemaUID が指定されていない場合は、DEFAULT_SCHEMA_UIDS.testnet.deployment を使用します。

{
  testnet: true,
  contractAddress: "0x...",
  contractName: "MyContract",
  deployer: "0x...",
  blockNumber: 1000000,
  transactionHash: "0x...",
  timestamp: 1700000000,
  abiHash: "0x...", // optional
  bytecodeHash: "0x...", // optional
  schemaUID: "0x...", // optional, uses default RAS schema
  recipient: "0x...", // optional
  walletData: {}, // wallet configuration
  walletPassword: "password"
}

✅ 検証のアテステーション

RAS のデフォルトの検証スキーマを使用して、コントラクト検証アテステーションを作成します。

{
  testnet: true,
  contractAddress: "0x...",
  contractName: "MyContract",
  verifier: "0x...",
  sourceCodeHash: "0x...",
  compilationTarget: "contracts/MyContract.sol:MyContract",
  compilerVersion: "v0.8.17+commit.8df45f5f",
  optimizationUsed: true,
  timestamp: 1700000000,
  verificationTool: "hardhat",
  schemaUID: "0x...", // optional, uses default RAS schema
  recipient: "0x...", // optional
  walletData: {}, // wallet configuration
  walletPassword: "password"
}

💸 送金のアテステーション

RAS のデフォルトの送金スキーマを使用して、送金アテステーションを作成します。

{
  testnet: true,
  sender: "0x...",
  recipient: "0x...",
  amount: "0.001",
  tokenSymbol: "RBTC", // optional, defaults to RBTC
  tokenAddress: "0x...", // optional, for ERC20
  transactionHash: "0x...",
  blockNumber: 1000000,
  timestamp: 1700000000,
  transferType: "native", // e.g. "native" or "erc20"
  reason: "payment", // optional
  schemaUID: "0x...", // optional, uses default RAS schema
  walletData: {}, // wallet configuration
  walletPassword: "password"
}

📁 プロジェクト構成

rsk-mcp-server/
├── src/
│   ├── handlers/
│   │   └── responsesHandler.ts    # MCP response handling
│   ├── services/
│   │   ├── AttestationService.ts  # Attestation operations
│   │   ├── ContractDeploymentService.ts # Contract deployment
│   │   ├── ContractReadService.ts # Contract reading
│   │   ├── ContractVerificationService.ts # Contract verification
│   │   ├── HistoryService.ts      # Transaction history
│   │   ├── TransferService.ts     # Token transfers
│   │   └── WalletService.ts       # Wallet management
│   ├── tools/
│   │   ├── constants.ts           # Constants and options
│   │   ├── handlers.ts            # Auxiliary handlers
│   │   ├── schemas.ts             # Zod validation schemas
│   │   └── types.ts               # TypeScript types
│   ├── utils/
│   │   └── responses.ts           # Response utilities
│   ├── server-config.ts           # MCP server configuration
│   ├── index.ts                   # Main entry point
│   └── rsk-cli.d.ts               # Ambient type declarations for rsk-cli
├── scripts/
│   └── test-attestations.mjs      # Attestation integration tests
├── build/                         # Compiled code (generated)
├── package.json                   # Project configuration
├── tsconfig.json                  # TypeScript configuration
└── README.md                      # This documentation

🔐 セキュリティ

秘密鍵の管理

• 秘密鍵は AES-256 を使用して暗号化して保存されます
• 各ウォレットには、それぞれ固有の IV（初期化ベクトル）が割り当てられます
• パスワードは平文で保存されません

ベストプラクティス

• 強力で固有のパスワードを使用してください
• my-wallets.json の安全なバックアップを保管してください
• 設定ファイルを共有しないでください
• テストにはテストネットを使用してください

🐛 トラブルシューティング

エラー：「Module not found」

npm install
npm run build

MCP 接続エラー

• 設定内の絶対パスを確認してください
• プロジェクトがコンパイルされていることを確認してください
• MCP クライアントのログを確認してください

ウォレットに関する問題

• my-wallets.json の形式を確認してください
• password.json のパスワードを確認してください（ファイルでパスワードを管理している場合）
• 取引に十分な資金があることを確認してください

貢献

コミュニティからの貢献を歓迎します。リポジトリをフォークし、変更を加えたうえでプルリクエストを送信してください。コードがプロジェクトの主な目的に沿っていることを確認してください。

サポート

ご質問やサポートが必要な場合は、リポジトリで Issue を作成するか、メンテナーにお問い合わせください。

免責事項

この GitHub リポジトリで提供されるソフトウェアは、明示的か黙示的かを問わず、商品性、特定目的への適合性、非侵害性の保証を含みますが、これらに限定されない、いかなる種類の保証も伴わず、「現状有姿」で提供されます。

• テスト： このソフトウェアはいかなるテストも受けておらず、その機能、正確性、信頼性、およびあらゆる目的への適合性は保証されません。
• 自己責任での使用： ユーザーは、このソフトウェアの使用に伴うすべてのリスクを負うものとします。このソフトウェアの作成者は、損害の可能性について通知を受けていた場合であっても、このソフトウェアの使用または使用不能に起因する、直接的、間接的、偶発的、特別、結果的、懲罰的な損害を含みますが、これらに限定されない、いかなる損害についても責任を負いません。
• 責任の否認： このソフトウェアの作成者は、このソフトウェアの使用または使用不能に起因する、利益の損失、事業の中断、情報またはデータの損失、その他の金銭的損失を含みますが、これらに限定されない、いかなる損失または損害についても責任を負いません。
• 単独責任： ユーザーは、このソフトウェアの出力または機能に基づいて行った決定や行動を含め、このソフトウェアの使用結果について単独で責任を負うことを認めます。
• 推奨の否認： 特定の製品、サービス、または組織への言及は、このソフトウェアの作成者による推奨を意味するものではありません。
• 変更および配布： このソフトウェアは、付属するライセンスの条件に従って変更および配布できます。このソフトウェアを変更または配布することにより、ライセンスの条件に拘束されることに同意したものとみなされます。
• リスクの引き受け： このソフトウェアを使用することにより、ユーザーは本免責事項の条件を読み、理解し、受け入れたことを認め、使用に伴うすべてのリスクを負うことに同意したものとみなされます。