Aptos MCP Server

🚀 套用 MCP 服務器

這是一個用於交互套用（Aptos）documentation 和創建全棧套用區塊鏈應用程序的模型上下文協議（MCP）服務器。它能幫助開發者更高效地進行區塊鏈應用開發，提供了豐富的功能和便捷的操作方式。

✨ 主要特性

• 🔍 可瀏覽和搜索套用 documentation，方便快速查找所需信息。
• 🔧 支持創建新的套用項目，涵蓋全棧、合同或客戶等不同類型。
• 🧩 能夠生成套用項目的組件，提高開發效率。
• 🧪 可以測試套用 Move 合同，確保合同的正確性。
• 📜 能為 Move 合同生成 TypeScript ABI 接口，便於與其他系統集成。

📦 安裝指南

前置條件

• Python 3.10 或更高版本
• Node.js 和 npm
• 套用 CLI（用於某些工具功能）

設置

1. 安裝 mcp 包：

uv add "mcp[cli]"
# 或者 
pip install "mcp[cli]"

2. 克隆此倉庫：

git clone https://github.com/yourusername/aptos-mcp-server.git
cd aptos-mcp-server

3. 安裝依賴項：

uv add httpx
# 或者
pip install httpx

4. （可選）設置 GitHub 令牌以提高 API 速率限制：

export GITHUB_TOKEN=your_github_token

💻 使用示例

與 Claude Desktop 結合使用

1. 從 claude.ai/download 安裝 Claude Desktop。
2. 將套用 MCP 服務器添加到你的 Claude Desktop 配置中：

mcp install aptos_mcp_server.py

或手動編輯 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "aptos-dev": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/aptos-mcp-server",
        "run",
        "aptos_mcp_server.py"
      ]
    }
  }
}

3. 重啟 Claude Desktop。

開發

以開發模式運行服務器並使用 MCP 檢查器：

mcp dev aptos_mcp_server.py

具體操作

一旦連接到 Claude Desktop，你可以執行以下操作：

瀏覽套用 Documentation

讓 Claude 瀏覽套用 documentation 倉庫的結構：

• "展示套用文檔的結構"
• "查找關於 Move 模塊的信息"
• "獲取 Table 實現文檔"

創建新項目

讓 Claude 幫助你設置新的套用項目：

• "創建一個名為 'my-first-dapp' 的套用全棧項目"
• "生成一個 marketplace 的 Move 智能合同"
• "設置一個僅限客戶的套用項目"

生成組件

讓 Claude 為你的套用項目生成組件：

• "生成 React 組件用於連接到套用錢包"
• "創建一個存儲用戶配置文件的 Move 表"
• "製作一個查詢合同數據的客戶函數"

測試和生成 ABIs

讓 Claude 測試合同並生成接口：

• "測試我的位於 ~/projects/my-dapp/move 的套用合同"
• "為我的 Move 合同生成 TypeScript 綁定"

示例查詢

• "瀏覽套用文檔"
• "在套用 docs 中搜索 'table'"
• "創建一個名為 'nft-marketplace' 的套用全棧項目"
• "生成一個代幣合同的 Move 模塊"
• "創建 React 組件用於錢包連接"
• "為我的合同生成 TypeScript ABI"
• "測試我合同中的撤回函數"

📄 許可證

本項目採用 MIT 許可證。