Skip to main content
Glama

Servidor MCP de Aptos

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la documentación de Aptos y crear aplicaciones blockchain de Aptos de pila completa.

Características

  • 🔍 Explorar y buscar documentación de Aptos

  • 🔧 Crear nuevos proyectos de Aptos (fullstack, contrato o cliente)

  • 🧩 Generar componentes para proyectos de Aptos

  • 🧪 Prueba los contratos de Aptos Move

  • 📜 Generar interfaces ABI de TypeScript para contratos Move

Related MCP server: Dedalus MCP Documentation Server

Instalación

Prerrequisitos

  • Python 3.10 o posterior

  • Node.js y npm

  • Aptos CLI (para algunas funciones de herramientas)

Configuración

  1. Instalar el paquete mcp:

uv add "mcp[cli]"
# or 
pip install "mcp[cli]"
  1. Clonar este repositorio:

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

uv add httpx
# or
pip install httpx
  1. (Opcional) Establezca el token de GitHub para aumentar los límites de velocidad de la API:

export GITHUB_TOKEN=your_github_token

Uso con Claude Desktop

  1. Instalar Claude Desktop desde claude.ai/download

  2. Agregue el servidor Aptos MCP a su configuración de Claude Desktop:

mcp install aptos_mcp_server.py

O edite manualmente ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %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. Reiniciar Claude Desktop

Desarrollo

Ejecute el servidor en modo de desarrollo con el Inspector MCP:

mcp dev aptos_mcp_server.py

Uso

Una vez conectado a Claude Desktop, podrá:

Explorar la documentación de Aptos

Pídale a Claude que explore el repositorio de documentación de Aptos:

  • "Muéstrame la estructura de la documentación de Aptos"

  • Encuentra información sobre los módulos Move en la documentación de Aptos.

  • "Consígueme la documentación de implementación de la tabla"

Crear nuevos proyectos

Pídele a Claude que configure nuevos proyectos de Aptos:

  • "Crea un nuevo proyecto completo de Aptos llamado 'mi-primera-dapp'"

  • Generar un contrato inteligente de Move para un mercado

  • Configurar un proyecto de Aptos solo para clientes

Generar componentes

Pídele a Claude que genere componentes para tus proyectos de Aptos:

  • Generar un componente React para conectarse a la billetera Aptos

  • "Crear una tabla Move para almacenar perfiles de usuario"

  • "Crear una función de cliente para consultar datos del contrato"

Probar y generar ABI

Pídale a Claude que pruebe contratos y genere interfaces:

  • Pruebe mi contrato de Aptos en ~/projects/my-dapp/move

  • Generar enlaces de TypeScript para mi contrato Move

Consultas de ejemplo

  • Explorar la documentación de Aptos

  • Busca "tabla" en la documentación de Aptos.

  • "Crear un nuevo proyecto fullstack de Aptos llamado 'nft-marketplace'"

  • Generar un módulo Move para un contrato de token

  • "Crear un componente React para la conexión de la billetera"

  • Generar ABI de TypeScript para mi contrato

  • "Prueba la función de retiro de mi contrato"

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Available Tools

6 tools
aptos_abi_generateC
Generate ABI for an Aptos contract.

Args:
    contract_path: Path to the contract directory
    output_format: Format of the output (ts, json)

Inputs: contract_path (required), output_format.

create_aptos_indexerC
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)

Inputs: project_name (required), processor_type.

create_aptos_projectC
Create a new Aptos project using the Aptos CLI.

Args:
    project_name: Name of the project
    project_type: Type of project (fullstack, contract, client)

Inputs: project_name (required), project_type.

create_gas_stationB
Creates a new Aptos gas station (fee sponsorship) project.

Args:
    project_name: Name of the gas station project

Inputs: project_name (required).

generate_aptos_componentC
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

Inputs: component_type (required), component_name (required), project_dir (required), options.

test_aptos_contractC
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

Inputs: contract_path (required), function_name, args.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: generating ABI, creating indexers, creating projects, creating gas stations, generating components, and testing contracts. The descriptions specify different resources and actions, making misselection unlikely.

    Naming Consistency4/5

    The naming follows a consistent verb_noun pattern with 'aptos' as a prefix (e.g., create_aptos_project, generate_aptos_component), except for 'aptos_abi_generate' which uses noun_verb order. This minor deviation slightly breaks the pattern but maintains overall readability.

    Tool Count5/5

    With 6 tools, the count is well-scoped for an Aptos development server, covering key operations like project setup, component generation, and testing. Each tool earns its place without feeling excessive or insufficient for the domain.

    Completeness3/5

    The toolset covers creation and testing aspects well but has notable gaps in lifecycle management, such as updating or deleting projects/components, and lacks deployment or interaction tools (e.g., deploy_contract, call_function). This limits full workflow coverage for Aptos development.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables users to manage API keys and perform Aptos Build actions through MCP-compatible interfaces like Claude and Cursor. This server facilitates development workflows on the Aptos blockchain by integrating directly with the Aptos Build platform.
      22
      73 npm
      13
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for Shelby Protocol that enables AI agents to read, write, and manage files on decentralized storage (Aptos) through tools like upload, download, list, delete, and account info.
      5
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Aptos MCP is a comprehensive Model Context Protocol (MCP) server implementation for the Aptos blockchain, compatible with MCP clients like Claude Desktop or Cursor.ai. It provides a complete DeFi toolkit covering major Aptos protocols including pool discovery, lending, DEX operations, perpetual trading, liquid staking, and cross-protocol portfolio management.
      33 npm
      MIT