Aptos

🚀 Aptos MCPサーバー

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

✨ 主な機能

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

📦 インストール

前提条件

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

セットアップ

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

uv add "mcp[cli]"
# または 
pip install "mcp[cli]"

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

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

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

uv add httpx
# または
pip install httpx

4. （オプション）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"
      ]
    }
  }
}

3. Claude Desktopを再起動します。

開発

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

mcp dev aptos_mcp_server.py

操作方法

Claude Desktopに接続したら、以下の操作ができます。

基本的な使用法

Aptosドキュメントの閲覧

ClaudeにAptosドキュメントライブラリの構造を表示させます。

• "Aptosドキュメントの構造を表示"
• "Moveモジュールに関する情報を検索"
• "Table実装のドキュメントを取得"

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

Claudeに新しいAptosプロジェクトを設定させます。

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

コンポーネントの生成

Claudeに現在のAptosプロジェクトのコンポーネントを生成させます。

• "Aptosウォレットに接続するためのReactコンポーネントを生成"
• "ユーザープロファイルを保存するMoveテーブルを作成"
• "コントラクトデータをクエリするためのクライアント関数を作成"

テストとABIの生成

Claudeにコントラクトをテストさせ、インターフェースを生成させます。

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

高度な使用法

サンプルクエリ

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

📄 ライセンス

MIT