create_aptos_project
Create a new Aptos project using the Aptos CLI.
LABSCO SUMMARY
Docs and scaffolding behind one connection.
Two jobs sit in one server: reading Aptos documentation, and writing the boilerplate a new Aptos project needs. The second is the reason to install it — a Move module, a wallet-connection component and the TypeScript bindings for a contract are exactly the files that are tedious to type and easy to get slightly wrong. Everything runs against a local checkout and the public docs repository, so there is no account and no key; the optional GitHub token only buys a higher read rate.
What it is
A Python MCP server for Aptos development. It reads the Aptos documentation repository, creates new fullstack, contract-only or client-only projects, generates components for them, runs Move contract tests, and produces TypeScript ABI interfaces from Move contracts.
What you get
- Search and navigation over the Aptos documentation repository, from structure down to a specific topic
- New Aptos projects scaffolded as fullstack, contract or client
- Generated pieces for an existing project — a Move module or table, a React wallet-connection component, a client function that queries a contract
- Move contract tests run against a local project path
- TypeScript ABI interfaces generated from a Move contract, so the front end is typed against the deployed code
Requirements
Python 3.10 or later, plus Node.js and npm; the Aptos CLI is needed for some of the tooling. Install the mcp package (uv add "mcp[cli]" or pip), clone the repository, add httpx, then either run mcp install aptos_mcp_server.py or point the client at uv --directory <YOUR_PATH_TO_APTOS_MCP_SERVER> run aptos_mcp_server.py. GITHUB_TOKEN is optional and only raises the GitHub API rate limit while reading the docs repository. The project is aptos-mcp 0.1.0; mcp dev aptos_mcp_server.py runs it under the MCP Inspector.
Setup effort
Build from source — git clone https://github.com/Tlazypanda/aptos-mcp-server.git
USE CASES
01
Starting an Aptos project from nothing
Have a fullstack, contract-only or client-only project scaffolded, then generated components added to it.
02
Looking something up in the Aptos docs mid-task
Search the documentation repository for the topic and read it without leaving the editor.
03
Typing a front end against a Move contract
Generate the TypeScript ABI interface from the contract so the client code is checked against the real signatures.
04
Running the Move tests you already have
Point it at the contract directory and have the test run reported back in the conversation.
6 tools
Listed in project code.
generate_aptos_component
Generate a new component for an Aptos project.
test_aptos_contract
Test an Aptos Move contract using the Aptos CLI.
create_aptos_indexer
Creates a new Aptos indexer project based on the example processor.
create_gas_station
Creates a new Aptos gas station (fee sponsorship) project.
aptos_abi_generate
Generate ABI for an Aptos contract.
BEFORE YOU INSTALL
What to know first
Tools you get
6 tools registered in the project's code.
Requires
- Python 3.10+
- uv
- Node.js and npm
- Aptos CLI (for the project, test and ABI tools)
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone https://github.com/Tlazypanda/aptos-mcp-server.git
cd aptos-mcp-server
uv add "mcp[cli]"
uv add httpxMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"aptos-dev": {
"command": "uv",
"args": [
"--directory",
"<YOUR_PATH_TO_APTOS_MCP_SERVER>",
"run",
"aptos_mcp_server.py"
]
}
}
}
