Aptos MCP Server

Aptos MCP服务器

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

特性

• 🔍 浏览和搜索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]"

1. 克隆此存储库：

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

1. 安装依赖项：

uv add httpx
# or
pip install httpx

1. （可选）为增加的API速率限制设置GitHub令牌：

export GITHUB_TOKEN=your_github_token

与Claude Desktop一起使用

1. 从以下位置安装Claude Desktop claude.ai/下载

1. 将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"
      ]
    }
  }
}

1. 重新启动克劳德桌面

发展

使用MCP Inspector在开发模式下运行服务器：

mcp dev aptos_mcp_server.py

用法

连接到Claude Desktop后，您可以：

浏览Aptos文档

让Claude浏览Aptos文档库：

• “显示Aptos文档结构”
• “在Aptos文档中查找有关Move模块的信息”
• “给我表格实现文档”

创建新项目

请Claude建立新的Aptos项目：

• “创建一个名为‘我的第一个dapp’的新Aptos全栈项目”
• “为市场生成Move智能合约”
• “设置仅限客户端的Aptos项目”

生成组件

请Claude为您的Aptos项目生成组件：

• “生成一个连接到Aptos钱包的React组件”
• “创建用于存储用户配置文件的移动表”
• “创建用于查询合同数据的客户端函数”

测试并生成ABI

请Claude测试合同并生成接口：

• “在~/projects/my dapp/move测试我的Aptos合约”
• “为我的Move合约生成TypeScript绑定”

查询示例

• “浏览Aptos文档”
• “在Aptos文档中搜索‘表’”
• “创建一个名为‘nft市场’的新Aptos全栈项目”
• “为代币合约生成Move模块”
• “创建用于钱包连接的React组件”
• “为我的合约生成TypeScript ABI”
• “测试我的合约的提款功能”

许可证

麻省理工学院