Aptos MCP Server

🚀 套用 MCP サーバー

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

✨ 主な機能

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

📦 インストール

前提条件

• Python 3.10以上
• Node.jsとnpm
• 套用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. 套用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チェッカーを使用する：

mcp dev aptos_mcp_server.py

💻 使用例

基本的な使用法

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

套用ドキュメントの閲覧

Claudeに套用ドキュメントリポジトリの構造を閲覧させる：

• "展示套用文档的结构"
• "查找关于Move模块的信息"
• "获取Table实现文档"

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

Claudeに新しい套用プロジェクトのセットアップを支援させる：

• "创建一个名为 'my-first-dapp' 的套用全栈项目"
• "生成一个marketplace的Move智能合同"
• "设置一个仅限客户的套用项目"

コンポーネントの生成

Claudeに套用プロジェクトのコンポーネントを生成させる：

• "生成React组件用于连接到套用钱包"
• "创建一个存储用户配置文件的Move表"
• "制作一个查询合同数据的客户函数"

テストとABIの生成

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

• "测试我的位于 ~/projects/my-dapp/move 的套用合同"
• "为我的Move合同生成TypeScript绑定"

高度な使用法

以下は、いくつかの具体的なクエリ例です：

• "浏览套用文档"
• "在套用docs中搜索 'table'"
• "创建一个名为 'nft-marketplace' 的套用全栈项目"
• "生成一个代币合同的Move模块"
• "创建React组件用于钱包连接"
• "为我的合同生成TypeScript ABI"
• "测试我合同中的撤回函数"

📄 ライセンス

MIT