aptos-mcp
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 (一部のツール機能用)
設定
mcp パッケージをインストールします。
uv add "mcp[cli]"
# or
pip install "mcp[cli]"このリポジトリをクローンします:
git clone https://github.com/yourusername/aptos-mcp-server.git
cd aptos-mcp-server依存関係をインストールします:
uv add httpx
# or
pip install httpx(オプション) API レート制限を増やすために GitHub トークンを設定します。
export GITHUB_TOKEN=your_github_tokenClaude Desktopでの使用
claude.ai/downloadからClaude Desktopをインストールします。
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"
]
}
}
}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 toolsaptos_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
Scored across 6 tools
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.
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.
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.
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
MCP server for agentverse documentation, generated by doc2mcp.
MCP server for Klever blockchain smart contract development.
The official MCP server for Capawesome documentation and Capawesome Cloud.
Related MCP Servers
AlicenseBqualityDmaintenanceEnables 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.2273 npm13Apache 2.0- AlicenseAqualityDmaintenanceAn MCP server that serves documentation and enables AI-powered search, Q\&A, and document analysis for developer tools and guides.54MIT
- AlicenseAqualityDmaintenanceMCP 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.51MIT
- AlicenseNot gradedqualityDmaintenanceAptos 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 npmMIT