Moveflow Aptos MCP Server

🚀 MoveFlow 服務端文檔

MoveFlow 服務端是一個用於與 Aptos 區塊鏈交互的服務器端組件，具備多種操作模式和安全架構設計。它能幫助開發者輕鬆實現與 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/連接器：處理服務端與客戶端之間的通信

這種設計消除了服務端對私鑰處理的需求，使其在生產環境中更加安全。

💻 使用示例

基礎用法

# 運行測試腳本
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 [倉庫地址]
   cd moveflow-aptos-mcp-server
   

2. 安裝依賴：

   npm install
   

3. 啟動開發服務器：

   npm start
   

📄 結束語

MoveFlow 服務端為與 Aptos 區塊鏈交互提供了強大的功能和靈活的安全架構。通過合理配置和使用，您可以輕鬆集成區塊鏈功能到您的應用中。