Near MCP Server

🚀 NEAR プロトコル MCP サーバー使用ガイド

この MCP サーバーは、NEAR プロトコルに関連するアカウント操作、コントラクトインタラクション、資産移転などの機能を提供します。以下の手順に従って、サーバーをセットアップし、使用することができます。

🚀 クイックスタート

NEAR プロトコル MCP サーバーを使用するには、まずサーバーをインストールし、設定する必要があります。以下の手順に従って操作してください。

📦 インストール

1. 依存関係のインストール

npm install near-api-js zod @types/node --save

2. プロジェクト構造の作成

your-near-mcp-server/
├── build/                 # コンパイル出力ディレクトリ
├── src/                  # ソースコード
│   └── index.ts          # メインプログラムファイル
└── .env                   # 環境変数設定

3. 環境変数の設定

プロジェクトのルートディレクトリに .env ファイルを作成または編集し、以下の内容を追加します。

MNEMONIC=your-24-word-mnemonic-or-empty
NEAR_NETWORK_ID=testnet # 選択可能な値: testnet、mainnet-beta

💻 サーバーの起動

開発モードでの起動

npm run dev

本番モードでの起動

npm start

✨ 主な機能

この MCP サーバーは以下の機能を提供します。

1. アカウント操作：
   • 残高の照会
   • アカウント詳細の表示
   • 子アカウントの作成
2. コントラクトインタラクション：
   • コントラクトメソッドの呼び出し
   • 新しいコントラクトのデプロイ
3. 資産移転：
   • NEAR トークンの送信
   • 子アカウントへの送金
4. 状態照会：
   • ブロック情報の取得
   • 取引履歴の表示
5. セキュリティ機能：
   • アクセスキーの管理
   • アカウントの削除
   • 署名の検証

💻 使用例

基本的な使用法

例 1：残高の照会

What's the balance of my account?

例 2：コントラクトメソッドの呼び出し

Call the 'add_message' function on 'guest-book.testnet' with arguments {"text": "Hello from MCP!"}

例 3：コントラクトのデプロイ

Deploy this contract (provide base64 WASM) to my account

📚 ドキュメント

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

⚠️ 重要提示

セキュリティを確保するために、以下の注意事項に従ってください。

1. 秘密鍵の管理：
   • ニーモニックを安全でない場所に保存しないでください。
   • 本番環境では、ハードウェアウォレットやその他のセキュリティ対策を使用することをおすすめします。
2. アクセス制御：
   • 高権限の操作へのアクセスを制限してください。
   • 定期的にシステムの活動を監査し、監視してください。
3. 入力検証：
   • ユーザーが提供するすべての入力に対して、厳格な形式チェックと消毒処理を行ってください。
4. ネットワーク問題：
   • サーバーが安定したネットワーク接続を持っていることを確認してください。
   • ネットワークの変動に対応するために、適切なエラー処理メカニズムを設定してください。

開発とデバッグ

デバッグコマンド

npm run check-index # TypeScript エラーのチェック

一般的な問題のトラブルシューティング

1. サーバーが起動しない場合：
   • コンソール出力を確認し、エラーメッセージがあるかどうかを確認してください。
   • すべての依存関係が正しくインストールされていることを確認してください。
2. 接続問題が発生した場合：
   • NEAR ネットワーク ID が正しく設定されていることを確認してください。
   • ニーモニックが有効であるか、または空であることを確認してください（空の場合はデフォルトのウォレットが使用されます）。
3. 機能が正常に動作しない場合：
   • ログファイルを確認し、詳細なエラー情報を取得してください。
   • NEAR API ドキュメントを参照し、呼び出し方法が正しいことを確認してください。

高度な設定

カスタムネットワーク

src/index.ts でネットワーク設定を変更します。

const config = {
  networkId: process.env.NEAR_NETWORK_ID || 'testnet',
  mnemonic: process.env.MNEMONIC,
}

機能拡張

• さらに多くの NEAR API メソッドを実装する。
• ログ記録と監視システムを追加する。
• リモート呼び出し用の Web インターフェイスを開発する。

ドキュメントの拡張

NEAR プロトコルについてさらに詳しく知りたい場合は、以下のリンクを参照してください。

• NEAR 公式ドキュメント
• Near CLI ツール

以上の手順に従って、機能が充実した NEAR プロトコル MCP サーバーを簡単にセットアップし、Claude Desktop と統合して使用することができます。設定または使用中に問題が発生した場合は、プロジェクトのドキュメントを参照するか、コミュニティのサポートに問い合わせてください。