Okto MCP Server

🚀 Okto Web3 MCP サーバー

Okto Web3 統合のためのモデルコンテキストプロトコル (MCP) サーバーです。Claude デスクトップアプリケーションに対応し、自動認証機能をサポートしています。このサーバーにより、AI アシスタントは自然言語対話を通じて Web3 トランザクションと資産ポートフォリオを管理することができます。

✨ 主な機能

• 保有資産や残高を含む資産ポートフォリオの詳細を確認する
• 複数のブロックチェーン上のアカウント情報を取得する
• アカウントに関連付けられたすべての NFT コレクションを一覧表示する
• 取引履歴を確認する
• 詳細な NFT 保有情報を確認する
• 利用可能なすべてのトークンとその詳細を一覧表示する
• トークンを指定されたアドレスに転送する
• サポートされているすべてのブロックチェーンネットワークのリストを取得する

📦 インストール

1. OAuth 認証情報の準備

• 有効な Google OAuth 2.0 認証情報ファイル gcp-oauth.keys.json を用意することを確認してください。
• このファイルを現在のディレクトリまたはユーザーのホームディレクトリ内の .okto-mcp フォルダに配置します。

2. 環境変数の設定

export OKTO_ENV=development  # または production

3. 認証フロー

• 認証スクリプトを実行してアクセストークンを取得します。
• スクリプトは自動的に認証情報ファイルを処理し、安全な認証セッションを確立します。

💻 Claude デスクトップアプリケーションの設定

~/.config/claude/web3.json に以下の設定を追加します。

{
  "mcp-server": {
    "url": "http://localhost:3000",
    "auth": {
      "type": "okto",
      "env": "${OKTO_ENV}"
    }
  }
}

💻 使用例

基本的な使用法

1. 資産ポートフォリオ詳細の照会

{
  "examples": ["すべてのチェーン上の資産状況を照会する"]
}

2. マルチチェーンアカウント情報の取得

{}

3. NFT コレクションの一覧表示

{}

4. 取引履歴の確認

{}

5. NFT 資産ポートフォリオの詳細表示

{}

6. 利用可能なトークンの一覧表示

{}

7. トークンの転送操作

転送パラメータを指定します。

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

8. サポートされているチェーンの一覧表示

{}

📚 ドキュメント

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

• OAuth 認証情報はローカル環境 (~/.okto-mcp) に安全に保存されます。
• サーバーはオフラインアクセスモードを使用して、永続的な認証状態を維持します。
• 認証情報を共有したり、バージョン管理システムにコミットしないでください。
• 定期的に未使用の Google アカウントの権限を確認し、取り消してください。
• Okto 認証情報は環境変数を通じて安全に保存する必要があります。
• 認証情報は現在のユーザーにのみアクセス可能です。

トラブルシューティング

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

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

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

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

3. ポートが既に使用されている場合

• ポート 3000 が使用されている場合は、そのポートを解放してから認証フローを実行してください。
• コマンドを使用して占有しているプロセスを検索し、終了させることができます。

4. Okto 認証に失敗した場合

• 環境変数の設定が正しいことを確認してください。
• Okto 認証情報が有効であることを確認してください。
• 正しい環境（テスト/本番）を使用していることを確認してください。

📄 ライセンス

ISC

サポートとフィードバック

問題が発生した場合や質問がある場合は、GitHub リポジトリに ISSUE を提出してください。