MCP 服务器

aptos-mcp

一个 MCP 服务器，用于与 Aptos 文档交互并创建全栈 Aptos 区块链应用程序。

Tools

create_aptos_project

Create a new Aptos project using the Aptos CLI. Args: project_name: Name of the project project_type: Type of project (fullstack, contract, client)

generate_aptos_component

Generate a new component for an Aptos project. Args: component_type: Type of component (table, module, etc.) component_name: Name of the component project_dir: Project directory path options: Additional options as a string

test_aptos_contract

Test an Aptos Move contract using the Aptos CLI. Args: contract_path: Path to the contract directory or file function_name: Optional function to test specifically args: Optional list of arguments for the function

create_aptos_indexer

Creates a new Aptos indexer project based on the example processor. Args: project_name: Name of the indexer project processor_type: Type of processor (transaction, event)

create_gas_station

Creates a new Aptos gas station (fee sponsorship) project. Args: project_name: Name of the gas station project

aptos_abi_generate

Generate ABI for an Aptos contract. Args: contract_path: Path to the contract directory output_format: Format of the output (ts, json)

README

Aptos MCP 服务器

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

功能

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

安装

前提条件

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

设置

安装 mcp 包：

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

克隆此存储库：

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

安装依赖项：

uv add httpx
# 或
pip install httpx

(可选) 设置 GitHub token 以提高 API 速率限制：

export GITHUB_TOKEN=your_github_token

与 Claude Desktop 一起使用

从 claude.ai/download 安装 Claude Desktop
将 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"
      ]
    }
  }
}

重启 Claude Desktop

开发

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

mcp dev aptos_mcp_server.py

用法

连接到 Claude Desktop 后，您可以：

浏览 Aptos 文档

要求 Claude 浏览 Aptos 文档存储库：

"Show me the Aptos documentation structure" (展示 Aptos 文档结构)
"Find information about Move modules in the Aptos docs" (在 Aptos 文档中查找有关 Move 模块的信息)
"Get me the Table implementation documentation" (获取 Table 实现文档)

创建新项目

要求 Claude 设置新的 Aptos 项目：

"Create a new Aptos full-stack project called 'my-first-dapp'" (创建一个名为 'my-first-dapp' 的新 Aptos 全栈项目)
"Generate a Move smart contract for a marketplace" (为市场生成一个 Move 智能合约)
"Set up a client-only Aptos project" (设置一个仅客户端的 Aptos 项目)

生成组件

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

"Generate a React component for connecting to Aptos wallet" (生成一个用于连接到 Aptos 钱包的 React 组件)
"Create a Move table for storing user profiles" (创建一个用于存储用户配置文件的 Move 表)
"Make a client function for querying contract data" (创建一个用于查询合约数据的客户端函数)

测试和生成 ABI

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

"Test my Aptos contract at ~/projects/my-dapp/move" (测试我在 ~/projects/my-dapp/move 的 Aptos 合约)
"Generate TypeScript bindings for my Move contract" (为我的 Move 合约生成 TypeScript 绑定)

示例查询

"Browse through the Aptos documentation" (浏览 Aptos 文档)
"Search the Aptos docs for 'table'" (在 Aptos 文档中搜索 'table')
"Create a new Aptos fullstack project called 'nft-marketplace'" (创建一个名为 'nft-marketplace' 的新 Aptos 全栈项目)
"Generate a Move module for a token contract" (为 token 合约生成一个 Move 模块)
"Create a React component for wallet connection" (创建一个用于钱包连接的 React 组件)
"Generate TypeScript ABI for my contract" (为我的合约生成 TypeScript ABI)
"Test my contract's withdraw function" (测试我的合约的 withdraw 函数)