跳转到内容

使用 Cursor 配置 Aptos MCP

Cursor 从 mcp.json 读取 MCP 服务器。可以使用项目级文件 .cursor/mcp.json,或用户级文件 ~/.cursor/mcp.json

  1. 打开 Cursor IDE
  2. 在项目根文件夹中,创建一个 .cursor 文件夹
  3. .cursor 文件夹中,创建一个 mcp.json 文件
  4. 粘贴以下内容
{
"mcpServers": {
"aptos-mcp": {
"command": "npx",
"args": ["-y", "@aptos-labs/aptos-mcp"],
"env": {
"APTOS_BOT_KEY": "${env:APTOS_BOT_KEY}"
}
}
}
}
  1. 获取你的 APTOS_BOT_KEY

    • 访问 Geomi 并登录账户。
    • 打开左下角账户菜单,进入 Bot Keys,然后创建新密钥。
    • 在 shell 中导出该密钥(export APTOS_BOT_KEY=...),或在本地把 ${env:APTOS_BOT_KEY} 替换为实际值。不要把密钥提交到 git。
  2. 保存文件。Cursor 会合并项目级和用户级 mcp.json;同名条目以项目配置为准。

  1. 打开 Cursor 设置:Cursor SettingsTools & MCP(也可以在 CustomizeMCP 中找到)。
  2. 确认 aptos-mcp 已启用并显示绿色指示器。

确保它已启用并显示绿色指示器

  1. 如果首次未能连接,点击 “refresh” 图标。

  2. 确保 Cursor 聊天处于 Agent 模式。

确保 Cursor AI 窗口下拉菜单设置为 Agent

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

向代理询问 what aptos mcp version are you using? 来验证连接。