Aptos MCP Server

Servidor MCP de Aptos

Un servidor de Model Context Protocol (MCP) para interactuar con la documentación de Aptos y crear aplicaciones blockchain full-stack de Aptos.

Características

• 🔍 Navegar y buscar documentación de Aptos
• 🔧 Crear nuevos proyectos de Aptos (fullstack, contrato o cliente)
• 🧩 Generar componentes para proyectos de Aptos
• 🧪 Probar contratos Move de Aptos
• 📜 Generar interfaces ABI de TypeScript para contratos Move

Instalación

Requisitos previos

• Python 3.10 o posterior
• Node.js y npm
• Aptos CLI (para algunas funciones de herramientas)

Configuración

1. Instala el paquete mcp:

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

2. Clona este repositorio:

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

3. Instala las dependencias:

uv add httpx
# or
pip install httpx

4. (Opcional) Configura el token de GitHub para aumentar los límites de tasa de API:

export GITHUB_TOKEN=your_github_token

Uso con Claude Desktop

1. Instala Claude Desktop desde claude.ai/download

2. Añade el servidor Aptos MCP a tu configuración de Claude Desktop:

mcp install aptos_mcp_server.py

O edita 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"
      ]
    }
  }
}

3. Reinicia Claude Desktop

Desarrollo

Ejecuta el servidor en modo desarrollo con el MCP Inspector:

mcp dev aptos_mcp_server.py

Uso

Una vez conectado a Claude Desktop, puedes:

Navegar por la documentación de Aptos

Pide a Claude que navegue por el repositorio de documentación de Aptos:

• "Muéstrame la estructura de la documentación de Aptos"
• "Encuentra información sobre módulos Move en la documentación de Aptos"
• "Dame la documentación de la implementación de Table"

Crear nuevos proyectos

Pide a Claude que configure nuevos proyectos de Aptos:

• "Crea un nuevo proyecto full-stack de Aptos llamado 'my-first-dapp'"
• "Genera un contrato inteligente Move para un marketplace"
• "Configura un proyecto de Aptos solo para cliente"

Generar componentes

Pide a Claude que genere componentes para tus proyectos de Aptos:

• "Genera un componente React para conectar con la billetera de Aptos"
• "Crea una tabla Move para almacenar perfiles de usuario"
• "Crea una función de cliente para consultar datos del contrato"

Probar y generar ABIs

Pide a Claude que pruebe contratos y genere interfaces:

• "Prueba mi contrato de Aptos en ~/projects/my-dapp/move"
• "Genera enlaces TypeScript para mi contrato Move"

Consultas de ejemplo

• "Navega por la documentación de Aptos"
• "Busca 'table' en la documentación de Aptos"
• "Crea un nuevo proyecto fullstack de Aptos llamado 'nft-marketplace'"
• "Genera un módulo Move para un contrato de token"
• "Crea un componente React para la conexión de billetera"
• "Genera ABI de TypeScript para mi contrato"
• "Prueba la función withdraw de mi contrato"

Licencia

MIT