Okto Web3 MCP Server

Okto Web3 MCP サーバー

Claude Desktop で Okto Web3 を統合するための Model Context Protocol（MCP）サーバーです。自動認証に対応しています。このサーバーを使用すると、AI アシスタントが自然言語でのやり取りを通じて Web3 のトランザクションやポートフォリオを管理できます。

機能

• 保有資産や残高など、ポートフォリオの詳細を表示
• 複数のチェーンにまたがるアカウント情報を取得
• NFT コレクションとポートフォリオを表示
• トランザクション履歴を確認
• アドレス間でトークンを転送
• 複数のブロックチェーンネットワークに対応
• 対応しているチェーンとトークンを表示
• ブラウザーを自動起動するシンプルな OAuth2 認証フロー
• デスクトップアプリと Web アプリケーションの両方の認証情報に対応
• 利便性のためのグローバルな認証情報の保存

インストールと認証

手動でインストールする

1. Google Cloud プロジェクトを作成し、認証情報を取得します。

   a. Google Cloud プロジェクトを作成します。

   • Google Cloud Console にアクセスします
   • 新しいプロジェクトを作成するか、既存のものを選択します
   • プロジェクトに必要な OAuth スコープを有効にします

   b. OAuth 2.0 認証情報を作成します。

   • 「API とサービス」>「認証情報」に移動します
   • 「認証情報を作成」>「OAuth クライアント ID」をクリックします
   • アプリケーションの種類として「デスクトップアプリ」または「ウェブアプリケーション」を選択します
   • 名前を付けて「作成」をクリックします
   • ウェブアプリケーションの場合は、認証済みのリダイレクト URI に http://localhost:3000/oauth2callback を追加します
   • クライアントの OAuth キーが含まれる JSON ファイルをダウンロードします
   • キーファイルの名前を gcp-oauth.keys.json に変更します

2. Okto の認証情報を設定します。

   https://dashboard.okto.tech/ から Okto の認証情報を取得します。

   OKTO_ENVIRONMENT=sandbox
   OKTO_CLIENT_PRIVATE_KEY=your_private_key
   OKTO_CLIENT_SWA=your_swa
   

3. 認証を実行します。

   次の 2 つの方法で認証できます。

   a. グローバル認証（推奨）：

   # First time: Place gcp-oauth.keys.json in your home directory's .okto-mcp folder
   mkdir -p ~/.okto-mcp
   mv gcp-oauth.keys.json ~/.okto-mcp/
   
   # Run authentication from anywhere
   npx @okto_web3/okto-mcp-server@latest auth
   

   b. ローカル認証：

   # Place gcp-oauth.keys.json in your current directory
   # The file will be automatically copied to global config
   npx @okto_web3/okto-mcp-server@latest auth
   

   認証プロセスでは、次の処理が行われます。

   • 現在のディレクトリまたは ~/.okto-mcp/ から gcp-oauth.keys.json を検索します
   • 現在のディレクトリに見つかった場合は、~/.okto-mcp/ にコピーします
   • Google 認証のために既定のブラウザーを開きます
   • 認証情報を ~/.okto-mcp/credentials.json として保存します

   注：

   • 認証が成功すると、認証情報は ~/.okto-mcp/ にグローバルに保存され、どのディレクトリからでも使用できます
   • デスクトップアプリと Web アプリケーションの両方の認証情報に対応しています
   • Web アプリケーションの認証情報を使用する場合は、認証済みのリダイレクト URI に http://localhost:3000/oauth2callback を追加してください

Claude Desktop の設定

以下を Claude Desktop の設定ファイル（macOS では通常 ~/Library/Application Support/Claude/claude_desktop_config.json にあります）に追加します。

{
  "mcpServers": {
    "okto": {
      "command": "node",
      "env": {
        "OKTO_ENVIRONMENT": "sandbox",
        "OKTO_CLIENT_PRIVATE_KEY": "your_private_key_here",
        "OKTO_CLIENT_SWA": "your_swa_here"
      },
      "args": [
        "/path/to/okto-mcp-server/build/index.js"
      ]
    }
  }
}

以下を置き換えます。

• your_private_key_here を Okto クライアントの秘密鍵に置き換えます
• your_swa_here を Okto クライアントの SWA に置き換えます
• /path/to/okto-mcp-server をサーバーをインストールした実際のパスに置き換えます

npm 経由でインストールした場合は、代わりに以下を使用できます。

{
  "mcpServers": {
    "okto": {
      "command": "npx",
      "env": {
        "OKTO_ENVIRONMENT": "sandbox",
        "OKTO_CLIENT_PRIVATE_KEY": "your_private_key_here",
        "OKTO_CLIENT_SWA": "your_swa_here"
      },
      "args": [
        "@okto_web3/okto-mcp-server@latest"
      ]
    }
  }
}

利用可能なツール

サーバーには、Claude Desktop から使用できる以下のツールが用意されています。

1. ポートフォリオを取得（get-portfolio）

保有資産や残高など、ポートフォリオの詳細情報を取得します。

2. アカウントを取得（get-account）

複数のチェーンにまたがるアカウントの詳細を取得します。

3. NFT コレクションを取得（get-nft-collections）

アカウントに関連付けられているすべての NFT コレクションを一覧表示します。

4. 注文履歴を取得（get-orders-history）

トランザクション履歴を取得します。

5. NFT ポートフォリオを取得（get-nft-portfolio）

NFT の保有状況の詳細を表示します。

6. トークンを取得（get-tokens）

利用可能なすべてのトークンとその詳細を一覧表示します。

7. トークンを転送（token-transfer）

アドレス間でトークンを転送します。

{
  "amount": "1000000000000000000",
  "recipient": "0x...",
  "token": "0x...",
  "caip2Id": "eip155:1"
}

8. チェーンを取得（get-chains）

対応しているすべてのブロックチェーンネットワークを一覧表示します。

セキュリティに関する注意事項

• OAuth 認証情報はローカル環境（~/.okto-mcp/）に安全に保存されます
• サーバーは、認証を維持するためにオフラインアクセスを使用します
• 認証情報を共有したり、バージョン管理にコミットしたりしないでください
• Google アカウントの設定で、使用していないアクセス権を定期的に確認して取り消してください
• Okto の認証情報は環境変数に安全に保存してください
• 認証情報はグローバルに保存されますが、アクセスできるのは現在のユーザーのみです

トラブルシューティング

1. OAuth キーが見つからない

   • gcp-oauth.keys.json が現在のディレクトリまたは ~/.okto-mcp/ にあることを確認してください
   • ファイルのアクセス権を確認してください

2. 認証情報の形式が無効

   • OAuth キーファイルに web または installed の認証情報が含まれていることを確認してください
   • ウェブアプリケーションの場合は、リダイレクト URI が正しく設定されていることを確認してください

3. ポートがすでに使用中

   • ポート 3000 がすでに使用されている場合は、認証を実行する前にポートを解放してください
   • そのポートを使用しているプロセスを見つけて停止できます

4. Okto の認証に失敗

   • 環境変数が正しく設定されていることを確認してください
   • Okto の認証情報が有効であることを確認してください
   • 正しい環境（サンドボックス／本番環境）を使用していることを確認してください

ライセンス

ISC

サポート

問題が発生した場合やご質問がある場合は、GitHub リポジトリでイシューを作成してください。