Skip to main content
Glama

Aptos MCP サーバー

Aptos ドキュメントと対話し、フルスタックの Aptos ブロックチェーン アプリケーションを作成するための Model Context Protocol (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 パッケージをインストールします。

uv add "mcp[cli]"
# or 
pip install "mcp[cli]"
  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. Aptos MCP サーバーを Claude Desktop 構成に追加します。

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デスクトップを再起動します

発達

MCP Inspector を使用して開発モードでサーバーを実行します。

mcp dev aptos_mcp_server.py

使用法

Claude Desktop に接続すると、次のことが可能になります。

Aptosドキュメントを参照する

Claude に Aptos ドキュメント リポジトリを参照するように依頼します。

  • 「Aptosのドキュメント構造を見せてください」

  • 「AptosドキュメントでMoveモジュールに関する情報を見つける」

  • 「テーブル実装ドキュメントを入手してください」

新しいプロジェクトを作成する

Claude に新しい Aptos プロジェクトを立ち上げるよう依頼します。

  • 「「my-first-dapp」という新しいAptosフルスタックプロジェクトを作成する」

  • 「マーケットプレイス用のMoveスマートコントラクトを生成する」

  • 「クライアント専用のAptosプロジェクトを設定する」

コンポーネントを生成する

Claude に Aptos プロジェクト用のコンポーネントを生成するよう依頼します。

  • 「Aptosウォレットに接続するためのReactコンポーネントを生成する」

  • 「ユーザープロファイルを保存するためのMoveテーブルを作成する」

  • 「契約データを照会するためのクライアント関数を作成する」

ABIのテストと生成

Claude に契約をテストし、インターフェースを生成するように依頼します。

  • 「~/projects/my-dapp/move で Aptos コントラクトをテストする」

  • 「MoveコントラクトのTypeScriptバインディングを生成する」

クエリの例

  • 「Aptosドキュメントを閲覧する」

  • 「Aptosドキュメントで「テーブル」を検索してください」

  • 「「nft-marketplace」という新しいAptosフルスタックプロジェクトを作成する」

  • 「トークンコントラクト用のMoveモジュールを生成する」

  • 「ウォレット接続用のReactコンポーネントを作成する」

  • 「契約用の TypeScript ABI を生成する」

  • 「契約の引き出し機能をテストする」

ライセンス

マサチューセッツ工科大学

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