Aptos MCP Server

🚀 Aptos MCP Server

A Model Context Protocol (MCP) server for interacting with Aptos documentation and creating full-stack blockchain applications.

🚀 Quick Start

The Aptos MCP Server is a powerful tool designed to interact with Aptos documentation and facilitate the creation of full - stack blockchain applications. It offers a range of features to streamline the development process.

✨ Features

• 🔍 Browse and search through the Aptos documentation.
• 🔧 Create new Aptos projects (full - stack, contracts, or clients).
• 🧩 Generate components for Aptos projects.
• 🧪 Test Aptos Move contracts.
• 📜 Generate TypeScript ABI interfaces for Move contracts.

📦 Installation

Prerequisites

• Python 3.10 or higher.
• Node.js and npm.
• Aptos CLI (for some tooling features).

Setup

1. Install the mcp package:

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

2. Clone this repository:

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

3. Install dependencies:

uv add httpx
# Or
pip install httpx

4. (Optional) Set a GitHub token to increase API rate limits:

export GITHUB_TOKEN=your_github_token

💻 Usage Examples

Usage with Claude Desktop

1. Install Claude Desktop from claude.ai/download.
2. Add the Aptos MCP Server to your Claude Desktop configuration:

mcp install aptos_mcp_server.py

Or manually edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %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. Restart Claude Desktop.

Development

Run the server in development mode and use the MCP checker:

mcp dev aptos_mcp_server.py

Basic Usage

Once connected to Claude Desktop, you can perform the following operations:

Browse Aptos Documentation

Ask Claude to explore the structure of the Aptos documentation repository:

• "Show the structure of the Aptos documentation."
• "Find information about Move modules."
• "Get documentation for Table implementation."

Create a New Project

Ask Claude to help you set up a new Aptos project:

• "Create a full - stack Aptos project named 'my - first - dapp'."
• "Generate a Move smart contract for a marketplace."
• "Set up a client - only Aptos project."

Generate Components

Ask Claude to generate components for your Aptos project:

• "Generate a React component to connect to an Aptos wallet."
• "Create a Move table to store user profiles."
• "Make a client function to query contract data."

Test and Generate ABIs

Ask Claude to test contracts and generate interfaces:

• "Test my Aptos contract located at ~/projects/my - dapp/move."
• "Generate TypeScript bindings for my Move contract."

Example Queries

• "Browse Aptos documentation."
• "Search for 'table' in the Aptos docs."
• "Create a full - stack Aptos project named 'nft - marketplace'."
• "Generate a Move module for a token contract."
• "Create a React component for wallet connection."
• "Generate a TypeScript ABI for my contract."
• "Test the withdrawal function in my contract."

📄 License

This project is licensed under the MIT license.