Aptos MCP 服务器

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

特征

• 🔍 浏览和搜索 Aptos 文档

• 🔧 创建新的 Aptos 项目（全栈、合同或客户端）

• 🧩 为 Aptos 项目生成组件

• 🧪 测试 Aptos Move 合约

• 📜 为 Move 合约生成 TypeScript ABI 接口

Related MCP server: Dedalus MCP Documentation Server

安装

先决条件

• 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 服务器添加到您的 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桌面

发展

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

mcp dev aptos_mcp_server.py

用法

一旦连接到 Claude Desktop，您可以：

浏览 Aptos 文档

让 Claude 浏览 Aptos 文档库：

• “向我展示 Aptos 文档结构”

• “在 Aptos 文档中查找有关 Move 模块的信息”

• “获取表格实现文档”

创建新项目

要求 Claude 设置新的 Aptos 项目：

• “创建一个名为‘my-first-dapp’的 Aptos 全栈项目”

• “为市场生成 Move 智能合约”

• “设置仅限客户端的 Aptos 项目”

生成组件

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

• “生成用于连接 Aptos 钱包的 React 组件”

• “创建一个移动表来存储用户配置文件”

• “制作一个查询合约数据的客户端函数”

测试并生成 ABI

要求Claude测试契约并生成接口：

• “在 ~/projects/my-dapp/move 测试我的 Aptos 合约”

• “为我的 Move 合约生成 TypeScript 绑定”

示例查询

• “浏览 Aptos 文档”

• “在 Aptos 文档中搜索‘table’”

• “创建一个名为‘nft-marketplace’的 Aptos 全栈项目”

• “为代币合约生成 Move 模块”

• “创建用于钱包连接的 React 组件”

• “为我的合约生成 TypeScript ABI”

• “测试我的合约的提现功能”

执照

麻省理工学院