Aptos

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

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "tlazypanda-aptos-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/aptos-mcp-server",
        "run",
        "aptos_mcp_server.py"
      ],
      "env": {
        "GITHUB_TOKEN": "YOUR_GITHUB_TOKEN"
      }
    }
  }
}

You are equipped with an MCP server that lets you interact with Aptos documentation, scaffold full-stack Aptos projects, generate components, test Move contracts, and generate TypeScript ABI interfaces. This server runs locally via a simple command and can be connected to trusted MCP clients to streamline your Aptos development workflow.

How to use

Connect your MCP client to the Aptos MCP Server to browse documentation, create new Aptos projects, generate components, test contracts, and generate TypeScript ABIs. You will typically run the server locally and then configure your MCP client to point at the local process. Use the MCP client to access features like project scaffolding, contract testing, and ABI generation without leaving your development environment.

How to install

Prerequisites you need before installation include Python 3.10 or later, Node.js and npm, and the Aptos CLI for some tooling features.

# Install the MCP client tooling
uv add "mcp[cli]"
# or
pip install "mcp[cli]"

How to install (continued)

Clone the Aptos MCP Server repository, then install runtime dependencies.

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

How to install (continued)

Install Python package dependencies for HTTP support.

uv add httpx
# or
pip install httpx

Optional setup

If you want to increase API rate limits when accessing GitHub resources, set your GitHub token.

export GITHUB_TOKEN=your_github_token

Run in development mode

When you are actively developing, you can run the server with the MCP Inspector to debug and inspect behavior.

mcp dev aptos_mcp_server.py

Claude Desktop integration

You can connect the Aptos MCP Server to Claude Desktop to access its features directly from the editor.

mcp install aptos_mcp_server.py

Available tools

browseDocs

Browse and search Aptos documentation to find information, tables, and usage patterns.

createProjects

Create new Aptos projects, including full-stack apps, Move contracts, or client-only setups.

generateComponents

Generate reusable components for Aptos projects, such as wallets integration or UI pieces.

testContracts

Test Aptos Move contracts to validate behavior and interoperability.

generateABIs

Generate TypeScript ABI interfaces for Move contracts to enable client integration.