使用 Cursor 配置 Aptos MCP
Cursor 从 mcp.json 读取 MCP 服务器。可以使用项目级文件 .cursor/mcp.json,或用户级文件 ~/.cursor/mcp.json。
- 打开 Cursor IDE
- 在项目根文件夹中,创建一个
.cursor文件夹 - 在
.cursor文件夹中,创建一个mcp.json文件 - 粘贴以下内容
{ "mcpServers": { "aptos-mcp": { "command": "npx", "args": ["-y", "@aptos-labs/aptos-mcp"], "env": { "APTOS_BOT_KEY": "${env:APTOS_BOT_KEY}" } } }}-
获取你的
APTOS_BOT_KEY:- 访问 Geomi 并登录账户。
- 打开左下角账户菜单,进入 Bot Keys,然后创建新密钥。
- 在 shell 中导出该密钥(
export APTOS_BOT_KEY=...),或在本地把${env:APTOS_BOT_KEY}替换为实际值。不要把密钥提交到 git。
-
保存文件。Cursor 会合并项目级和用户级
mcp.json;同名条目以项目配置为准。
验证 Cursor 运行你的 MCP
Section titled “验证 Cursor 运行你的 MCP”- 打开 Cursor 设置:Cursor Settings → Tools & MCP(也可以在 Customize → MCP 中找到)。
- 确认
aptos-mcp已启用并显示绿色指示器。

-
如果首次未能连接,点击 “refresh” 图标。
-
确保 Cursor 聊天处于 Agent 模式。

- 向代理询问
what aptos mcp version are you using?以验证连接。它应返回 MCP Server Card 中当前发布的@aptos-labs/aptos-mcp版本。
