aptos-mcp

Integrations

  • Enables access to Aptos documentation repositories with optional GitHub token support for increased API rate limits.

  • Supports creating Aptos client projects that use Node.js for blockchain interaction.

  • Supports generating React components for Aptos blockchain applications, such as wallet connection interfaces.

Aptos MCP 服务器

用于与 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]"
  1. 克隆此存储库:
git clone https://github.com/yourusername/aptos-mcp-server.git cd aptos-mcp-server
  1. 安装依赖项:
uv add httpx # or pip install httpx
  1. (可选)设置 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" ] } } }
  1. 重启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”
  • “测试我的合约的提现功能”

执照

麻省理工学院

ID: wrflhe12gq