Skip to main content
Glama

Aptos MCP 서버

Aptos 문서와 상호작용하고 풀스택 Aptos 블록체인 애플리케이션을 생성하기 위한 MCP(모델 컨텍스트 프로토콜) 서버입니다.

특징

  • 🔍 Aptos 문서를 탐색하고 검색하세요

  • 🔧 새로운 Aptos 프로젝트(풀스택, 계약 또는 클라이언트)를 생성하세요

  • 🧩 Aptos 프로젝트를 위한 구성 요소 생성

  • 🧪 Aptos Move 계약 테스트

  • 📜 Move 계약에 대한 TypeScript ABI 인터페이스 생성

Related MCP server: Dedalus MCP Documentation Server

설치

필수 조건

  • Python 3.10 이상

  • Node.js와 npm

  • Aptos CLI(일부 툴링 기능용)

설정

  1. mcp 패키지를 설치하세요:

지엑스피1

  1. 이 저장소를 복제하세요:

git clone https://github.com/yourusername/aptos-mcp-server.git
cd aptos-mcp-server
  1. 종속성 설치:

uv add httpx
# or
pip install httpx
  1. (선택 사항) API 속도 제한을 높이기 위해 GitHub 토큰을 설정합니다.

export GITHUB_TOKEN=your_github_token

Claude Desktop과 함께 사용

  1. claude.ai/download 에서 Claude Desktop을 설치하세요

  2. Claude Desktop 구성에 Aptos MCP 서버를 추가합니다.

mcp install aptos_mcp_server.py

또는 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 또는 %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. Claude Desktop을 다시 시작하세요

개발

MCP Inspector를 사용하여 개발 모드에서 서버를 실행합니다.

mcp dev aptos_mcp_server.py

용법

Claude Desktop에 연결하면 다음을 수행할 수 있습니다.

Aptos 문서 찾아보기

Claude에게 Aptos 문서 저장소를 탐색해 보라고 요청하세요.

  • "Aptos 문서 구조를 보여주세요"

  • "Aptos 문서에서 Move 모듈에 대한 정보를 찾아보세요"

  • "Table 구현 문서를 가져와주세요"

새 프로젝트 만들기

Claude에게 새로운 Aptos 프로젝트를 설정해 달라고 요청하세요.

  • "'my-first-dapp'이라는 이름의 새로운 Aptos 풀스택 프로젝트를 생성하세요."

  • "마켓플레이스를 위한 Move 스마트 계약 생성"

  • "클라이언트 전용 Aptos 프로젝트 설정"

구성 요소 생성

Claude에게 Aptos 프로젝트에 필요한 구성 요소를 생성해 달라고 요청하세요.

  • "Aptos 지갑에 연결하기 위한 React 컴포넌트 생성"

  • "사용자 프로필을 저장하기 위한 이동 테이블 만들기"

  • "계약 데이터를 쿼리하기 위한 클라이언트 함수를 만들어 보세요"

ABI 테스트 및 생성

Claude에게 계약을 테스트하고 인터페이스를 생성하도록 요청하세요.

  • "~/projects/my-dapp/move에서 Aptos 계약을 테스트하세요"

  • "Move 계약에 대한 TypeScript 바인딩 생성"

예제 쿼리

  • "Aptos 문서를 탐색하세요"

  • "Aptos 문서에서 'table'을 검색하세요"

  • "nft-marketplace"라는 새로운 Aptos 풀스택 프로젝트를 만드세요.

  • "토큰 계약에 대한 Move 모듈 생성"

  • "지갑 연결을 위한 React 컴포넌트 만들기"

  • "내 계약에 대한 TypeScript ABI를 생성하세요"

  • "내 계약의 철회 기능을 테스트하세요"

특허

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