Aptos MCP Server

Aptos MCP サーバー

Aptos のドキュメントを参照し、フルスタックの Aptos ブロックチェーンアプリケーションを作成するための Model Context Protocol（MCP）サーバーです。

機能

• 🔍 Aptos のドキュメントを閲覧、検索
• 🔧 新しい Aptos プロジェクトを作成（フルスタック、コントラクト、またはクライアント）
• 🧩 Aptos プロジェクト用のコンポーネントを生成
• 🧪 Aptos Move コントラクトをテスト
• 📜 Move コントラクト用の TypeScript ABI インターフェースを生成

インストール

前提条件

• Python 3.10 以降
• Node.js と npm
• Aptos CLI（一部のツール機能で必要）

セットアップ

1. mcp パッケージをインストールします：

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

2. このリポジトリをクローンします：

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

3. 依存関係をインストールします：

uv add httpx
# or
pip install httpx

4. （任意）API レート制限を引き上げるために GitHub トークンを設定します：

export GITHUB_TOKEN=your_github_token

Claude Desktop での使用

1. claude.ai/download から Claude Desktop をインストールします

2. Claude Desktop の設定に Aptos MCP Server を追加します：

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

3. Claude Desktop を再起動します

開発

MCP Inspector を使って、開発モードでサーバーを実行します：

mcp dev aptos_mcp_server.py

使用方法

Claude Desktop に接続すると、次のことができます：

Aptos のドキュメントを閲覧

Aptos のドキュメントリポジトリを閲覧するよう Claude に依頼できます：

• 「Aptos のドキュメント構成を表示して」
• 「Aptos のドキュメントで Move モジュールに関する情報を探して」
• 「Table の実装に関するドキュメントを見せて」

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

新しい Aptos プロジェクトのセットアップを Claude に依頼できます：

• 「my-first-dapp という名前の新しい Aptos フルスタックプロジェクトを作成して」
• 「マーケットプレイス用の Move スマートコントラクトを生成して」
• 「クライアントのみの Aptos プロジェクトをセットアップして」

コンポーネントを生成

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

• 「Aptos ウォレットに接続する React コンポーネントを生成して」
• 「ユーザープロフィールを保存する Move テーブルを作成して」
• 「コントラクトデータを取得するクライアント関数を作成して」

ABI のテストと生成

コントラクトのテストやインターフェースの生成を Claude に依頼できます：

• 「~/projects/my-dapp/move にある Aptos コントラクトをテストして」
• 「Move コントラクト用の TypeScript バインディングを生成して」

クエリの例

• 「Aptos のドキュメントを閲覧して」
• 「Aptos のドキュメントで「table」を検索して」
• 「nft-marketplace という名前の新しい Aptos フルスタックプロジェクトを作成して」
• 「トークンコントラクト用の Move モジュールを生成して」
• 「ウォレット接続用の React コンポーネントを作成して」
• 「コントラクト用の TypeScript ABI を生成して」
• 「コントラクトの withdraw 関数をテストして」

ライセンス

MIT