Aptos MCP Server

Aptos MCP Server

用于与 Aptos 文档交互并创建全栈 Aptos 区块链应用的模型上下文协议（MCP）服务。

功能

• 🔍 浏览和搜索 Aptos 文档
• 🔧 创建新的 Aptos 项目（全栈、合约或客户端）
• 🧩 为 Aptos 项目生成组件
• 🧪 测试 Aptos Move 合约
• 📜 为 Move 合约生成 TypeScript ABI 接口

安装

前置要求

• Python 3.10 或更高版本
• Node.js 和 npm
• Aptos CLI（用于部分工具功能）

设置

1. 安装 mcp 包：

uv add "mcp[cli]"
# or 
pip install "mcp[cli]"

2. 克隆此仓库：

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

3. 安装依赖：

uv add httpx
# or
pip install httpx

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

export GITHUB_TOKEN=your_github_token

与 Claude Desktop 搭配使用

1. 从 claude.ai/download 安装 Claude Desktop

2. 将 Aptos MCP Server 添加到 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 后，你可以：

浏览 Aptos 文档

让 Claude 浏览 Aptos 文档仓库：

• “向我展示 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”
• “测试我合约的 withdraw 函数”

许可证

MIT