Moveflow Aptos MCP Server

🚀 MoveFlow サーバードキュメント

MoveFlow サーバーは、Aptos ブロックチェーンとのやり取りを行うサーバーサイドコンポーネントです。複数の操作モードとセキュリティアーキテクチャ設計をサポートしています。このドキュメントでは、その機能、設定、セキュリティ、開発情報について詳しく説明します。

🚀 クイックスタート

依存関係のインストール

npm install moveflow-aptos-mcp-server

サーバーの起動

const { MoveFlowServer } = require('moveflow-aptos-mcp-server');

// 初期設定
const config = {
  aptosNodeUrl: 'https://fullnode.mainnet.aptoslabs.com',
  network: 'mainnet',
  readOnlyMode: true,
};

// サーバーを起動
new MoveFlowServer(config).start();

ツールの使用

const { tools } = require('moveflow-aptos-mcp-server');

// 残高を照会
tools.balance.queryBalance("0x1", (error, result) => {
  if (error) return console.error(error);
  console.log(result);
});

✨ 主な機能

コア機能

• ブロックチェーンとのやり取り：アダプターを介して Aptos ブロックチェーンと通信します。
• MCP ツールの統合：複数の Move Command Processor（MCP）ツールを提供し、豊富なブロックチェーン操作をサポートします。
• セキュリティモード：読み取り専用モード、クライアント署名モード、直接署名モードをサポートします。

サポートされる操作

• データの照会：ブロックチェーンからトランザクションやアカウント情報などを照会します。
• トランザクションの準備：トランザクションオブジェクトを生成しますが、署名は行いません。
• トランザクションの署名と送信：直接署名モードでは、提供された秘密鍵を使用してトランザクションに署名し、送信します。

📦 インストール

環境変数

• SIGNING_MODE を "direct" に設定し、READ_ONLY_MODE を "false" に設定した場合に必要です。

🔧 技術詳細

クライアント署名モデル

サーバーは秘密鍵を保存しないように設計されています。

1. 読み取り専用モード：
   • デフォルトで推奨される動作モードです。
   • ブロックチェーンデータの照会のみが許可されます。
   • トランザクションを実行することはできません。
   • READ_ONLY_MODE="true" で有効にします。
2. トランザクション準備モード：
   • READ_ONLY_MODE を "false" に設定した場合に使用されます。
   • サーバーはトランザクションを準備しますが、署名は行いません。
   • トランザクションはクライアントアプリケーションで署名する必要があります。
   • トランザクションの準備と署名を分離することで、セキュリティが強化されます。
3. 直接署名モード（開発用）：
   • SIGNING_MODE を "direct" に設定し、APTOS_PRIVATE_KEY を提供した場合に使用されます。
   • サーバーは提供された秘密鍵を使用してトランザクションに署名し、送信します。
   • セキュリティが低いですが、テストが容易です。
   • 本番環境での使用はお勧めしません。

セキュアなトランザクションアーキテクチャ

サーバーのアーキテクチャは、役割を分離しています。

• サーバー：入力を検証し、トランザクションオブジェクトを準備します。
• クライアント：秘密鍵を管理し、トランザクションに署名します。
• API/コネクタ：サーバーとクライアント間の通信を処理します。

この設計により、サーバーが秘密鍵を処理する必要がなくなり、本番環境でのセキュリティが向上します。

📚 ドキュメント

MCP ツールのテスト

サーバーには、すべての MCP ツールが正常に動作することを検証するためのテストスクリプトが含まれています。

# テストスクリプトを実行
npm run test-tools

これにより、各 MCP ツールに対する一連のテストが実行され、その正しい機能が検証されます。また、test-tools.js の設定を編集することで、異なるネットワークや署名モードを使用することもできます。

開発

プロジェクト構造

サーバーのコードベースは以下のように組織されています。

moveflow_aptos_mcp_server/
├── src/                    # ソースコード
│   ├── adapters/          # ブロックチェーンアダプター
│   ├── tools/             # MCP ツールのセット
│   └── server.js         # サーバーのメインファイル
├── package.json         # 依存関係の管理
└── README.md            # ドキュメント

開発手順

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

   git clone [リポジトリのURL]
   cd moveflow-aptos-mcp-server
   

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

   npm install
   

3. 開発サーバーを起動する：

   npm start
   

📄 まとめ

MoveFlow サーバーは、Aptos ブロックチェーンとのやり取りに強力な機能と柔軟なセキュリティアーキテクチャを提供します。適切な設定と使用方法により、ブロックチェーン機能をアプリケーションに簡単に統合することができます。