Aptos

🚀 Aptos MCP 服務器

Aptos MCP 服務器是一個用於交互 Aptos 文檔並創建全棧 Aptos 區塊鏈應用程序的模型上下文協議（MCP）服務器，能夠幫助開發者更高效地進行 Aptos 項目的開發與測試。

🚀 快速開始

Aptos MCP 服務器可助力開發者與 Aptos 文檔交互並創建全棧區塊鏈應用程序。按以下步驟操作，即可快速開啟使用之旅。

✨ 主要特性

• 🔍 瀏覽和搜索 Aptos 文檔，方便開發者快速獲取所需信息。
• 🔧 創建新的 Aptos 項目（全棧、合約或客戶端），滿足不同開發場景需求。
• 🧩 生成 Aptos 項目的組件，提高開發效率。
• 🧪 測試 Aptos Move 合約，確保合約的正確性和穩定性。
• 📜 為 Move 合約生成 TypeScript ABI 接口，便於與其他系統集成。

📦 安裝指南

先決條件

• Python 3.10 或更高版本
• Node.js 和 npm
• Aptos 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. 將 Aptos 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 Inspector：

mcp dev aptos_mcp_server.py

連接到 Claude Desktop 後的操作

基礎用法

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

• 瀏覽 Aptos 文檔：讓 Claude 展示 Aptos 文檔庫的結構，例如：
  • "顯示 Aptos 文檔結構"
  • "查找有關 Move 模塊的信息"
  • "獲取 Table 實現文檔"
• 創建新項目：讓 Claude 設置新的 Aptos 項目，例如：
  • "創建名為'my-first-dapp'的新 Aptos 全棧項目"
  • "為市場生成一個 Move 智能合約"
  • "設置一個僅客戶端的 Aptos 項目"
• 生成組件：讓 Claude 為你當前的 Aptos 項目生成組件，例如：
  • "生成用於連接到 Aptos 錢包的 React 組件"
  • "創建存儲用戶配置文件的 Move 表格"
  • "為查詢合同數據創建客戶端函數"
• 測試和生成 ABI：讓 Claude 測試合約並生成接口，例如：
  • "測試我在~/projects/my-dapp/move 處的 Aptos 合約"
  • "為我的 Move 合約生成 TypeScript 綁定"

高級用法

以下是一些示例查詢，展示了更多高級的使用場景：

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

📄 許可證

本項目採用 MIT 許可證。