aptos-mcp
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
Instalar el paquete mcp:
uv add "mcp[cli]"
# or
pip install "mcp[cli]"Clonar este repositorio:
git clone https://github.com/yourusername/aptos-mcp-server.git
cd aptos-mcp-serverInstalar dependencias:
uv add httpx
# or
pip install httpx(Opcional) Establezca el token de GitHub para aumentar los límites de velocidad de la API:
export GITHUB_TOKEN=your_github_tokenUso con Claude Desktop
Instalar Claude Desktop desde claude.ai/download
Agregue el servidor Aptos MCP a su configuración de Claude Desktop:
mcp install aptos_mcp_server.pyO 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"
]
}
}
}Reiniciar Claude Desktop
Desarrollo
Ejecute el servidor en modo de desarrollo con el Inspector MCP:
mcp dev aptos_mcp_server.pyUso
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 toolsaptos_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
Scored across 6 tools
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.
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.
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.
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
MCP server for agentverse documentation, generated by doc2mcp.
MCP server for Klever blockchain smart contract development.
The official MCP server for Capawesome documentation and Capawesome Cloud.
Related MCP Servers
AlicenseBqualityDmaintenanceEnables 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.2273 npm13Apache 2.0- AlicenseAqualityDmaintenanceAn MCP server that serves documentation and enables AI-powered search, Q\&A, and document analysis for developer tools and guides.54MIT
- AlicenseAqualityDmaintenanceMCP 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.51MIT
- AlicenseNot gradedqualityDmaintenanceAptos 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 npmMIT