Aptos MCP Server

Aptos MCP Server

Um servidor Model Context Protocol (MCP) para interagir com a documentação do Aptos e criar aplicações blockchain Aptos full-stack.

Recursos

• 🔍 Navegar e pesquisar na documentação do Aptos
• 🔧 Criar novos projetos Aptos (fullstack, contrato ou cliente)
• 🧩 Gerar componentes para projetos Aptos
• 🧪 Testar contratos Move do Aptos
• 📜 Gerar interfaces ABI TypeScript para contratos Move

Instalação

Pré-requisitos

• Python 3.10 ou posterior
• Node.js e npm
• Aptos CLI (para alguns recursos de ferramentas)

Configuração

1. Instale o pacote mcp:

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

2. Clone este repositório:

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

3. Instale as dependências:

uv add httpx
# or
pip install httpx

4. (Opcional) Defina o token do GitHub para aumentar os limites de taxa da API:

export GITHUB_TOKEN=your_github_token

Uso com o Claude Desktop

1. Instale o Claude Desktop em claude.ai/download

2. Adicione o Aptos MCP Server à sua configuração do Claude Desktop:

mcp install aptos_mcp_server.py

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

Desenvolvimento

Execute o servidor em modo de desenvolvimento com o MCP Inspector:

mcp dev aptos_mcp_server.py

Uso

Depois de conectado ao Claude Desktop, você pode:

Navegar pela documentação do Aptos

Peça ao Claude para navegar pelo repositório de documentação do Aptos:

• "Mostre-me a estrutura da documentação do Aptos"
• "Encontre informações sobre módulos Move na documentação do Aptos"
• "Obtenha a documentação da implementação de Table"

Criar novos projetos

Peça ao Claude para configurar novos projetos Aptos:

• "Crie um novo projeto Aptos full-stack chamado 'my-first-dapp'"
• "Gere um contrato inteligente Move para um marketplace"
• "Configure um projeto Aptos somente cliente"

Gerar componentes

Peça ao Claude para gerar componentes para seus projetos Aptos:

• "Gere um componente React para conectar à carteira Aptos"
• "Crie uma tabela Move para armazenar perfis de usuários"
• "Crie uma função cliente para consultar dados de contrato"

Testar e gerar ABIs

Peça ao Claude para testar contratos e gerar interfaces:

• "Teste meu contrato Aptos em ~/projects/my-dapp/move"
• "Gere bindings TypeScript para meu contrato Move"

Exemplos de consultas

• "Navegue pela documentação do Aptos"
• "Pesquise na documentação do Aptos por 'table'"
• "Crie um novo projeto Aptos fullstack chamado 'nft-marketplace'"
• "Gere um módulo Move para um contrato de token"
• "Crie um componente React para conexão de carteira"
• "Gere ABI TypeScript para meu contrato"
• "Teste a função de saque do meu contrato"

Licença

MIT