Aptos 开发的 AI 工具

Aptos 为 AI 驱动的开发工作流提供一流支持。无论您使用的是 AI 编程助手还是 AI 聊天工具， 都可以让它深入了解 Aptos 区块链、Move 语言、SDK 和 API。

Aptos MCP 服务器

模型上下文协议 (MCP) 让 AI 编程工具能够直接调用 Aptos API、 查询链上数据并生成正确的 Aptos 代码，无需复制粘贴文档。

Claude Code 为 Claude Code 配置 Aptos MCP 服务器

Cursor 为 Cursor 配置 Aptos MCP 服务器

OpenAI Codex 为 Codex 配置 Aptos MCP 服务器

任何能够启动本地 stdio 服务器的 MCP 客户端（包括 GitHub Copilot）都可以使用相同的 npx -y @aptos-labs/aptos-mcp 命令。前置要求和 Geomi Bot Key 请参阅 Aptos MCP 概览。

Aptos Agent Skills

Aptos Agent Skills 提供预构建 AI 技能， 为编程助手提供深度 Aptos 专业知识——涵盖 Move 智能合约、TypeScript SDK 和全栈 dApp 脚手架。

npx skills add aptos-labs/aptos-agent-skills

此命令使用通过 npx 调用的 Skills CLI。如果当前环境中没有 npx skills，请确认已安装 Node.js 与 npm，并参考 Skills CLI 文档完成安装与排查。

Aptos Agent Skills 浏览所有可用技能，包括 Move 开发、TypeScript SDK 和项目脚手架

LLMs.txt 文档源

LLMs.txt 标准提供机器可读的文档源，AI 工具可以摄取这些内容以理解完整的 Aptos 文档。我们发布三种文档源以适应不同的上下文窗口大小：

文档源	URL	最适合
llms.txt	/llms.txt	包含页面标题、描述和逐页 .md 链接的结构化索引
llms-small.txt	/llms-small.txt	适合较小上下文窗口的压缩文档
llms-full.txt	/llms-full.txt	完整文档——所有页面串联在一起

部分客户端会解析 /.well-known/llms.txt；生产环境会通过重定向提供与 /llms.txt 相同的索引（https://aptos.dev/.well-known/llms.txt）。

llms.txt 路由还会列出机器可读的 API 链接——/aptos-spec.json（全节点 REST API 的 OpenAPI 3 JSON）以及 /zh/rest-api（HTML 参考文档）——并在同一处汇总 MCP、Agent Skills、浏览器、GitHub、标准与 Indexer GraphQL 等 .md 链接。

如何在 AI 工具中使用 LLMs.txt Cursor、Claude Code、GitHub Copilot、ChatGPT、Codex、Devin Desktop 等工具的使用说明

面向智能体的发现端点

为方便编程智能体一站式发现 Aptos 的机器可读资源，文档站点发布了一组标准化的发现文档。每个页面的响应也会带上 Link 响应头与对应的 <link rel="…"> 标签，指向相同的 URL。

端点	作用
/.well-known/api-catalog	符合 RFC 9727 的 linkset，指向 REST API 规范、文档、Indexer GraphQL 以及 LLMs.txt 文档源。
/.well-known/mcp/server-card.json	描述 @aptos-labs/aptos-mcp 的 MCP Server Card (SEP-2127)。
/.well-known/agent-skills/index.json	基于 Agent Skills Discovery 的 aptos-agent-skills 索引，包含每个技能的 SHA-256 摘要。
/.well-known/oauth-protected-resource	面向 https://aptos.dev 的 OAuth 2.0 受保护资源元数据（RFC 9728），列出资源标识符、Aptos 测试网水龙头 使用的 Firebase + Google 授权服务器以及支持的 scopes。
/.well-known/openid-configuration	OpenID Connect Discovery 1.0 文档，描述 Aptos 测试网水龙头 登录所使用的 issuer、授权与令牌端点、JWKS URI 与支持的授权类型。
/.well-known/oauth-authorization-server	面向偏好纯 OAuth 2.0 端点名称的客户端的 OAuth 2.0 授权服务器元数据（RFC 8414） 副本，与上面的 OIDC 发现文档内容一致。
/.well-known/ai-catalog.json	ARD / AI Catalog 能力清单，列出 MCP Server Card、Agent Skills 索引、REST OpenAPI 规范以及 RFC 9727 API catalog。
/auth.md	auth.md 智能体认证说明。写明 aptos.dev 为公开文档（不提供智能体注册），测试网水龙头使用人类 Google OIDC 登录。
/robots.txt	包含 Content Signals（ai-train=yes, search=yes, ai-input=yes）、指向 AI Catalog 的 Agentmap: 指令，以及 Sitemap: https://aptos.dev/sitemap.xml。

源站级 RFC 9728 文档将资源标识符设为 https://aptos.dev，以便要求 resource 与本主机一致的客户端能够接受该文档。本主机上的文档无需鉴权。列出的授权服务器（Firebase + Google）签发 Aptos 测试网水龙头 在 Authorization: Bearer … 头中接受的令牌；水龙头 API 本身位于 https://faucet.testnet.aptoslabs.com。/auth.md 是对应的说明文档：本站没有智能体注册端点。

DNS for AI Discovery（DNS-AID）

DNS-AID 记录无法从本仓库发布。aptos.dev 托管在 Google Cloud DNS 上（ns-cloud-c1.googledomains.com 至 ns-cloud-c4.googledomains.com）。

组织索引记录已经存在：

_index._agents.aptos.dev. 3600 IN HTTPS 1 aptos.dev. alpn="h2,h3" port=443

该记录将智能体指向 https://aptos.dev，此处已托管 MCP Server Card、API catalog、AI Catalog 以及其他 well-known 文档。在 Aptos 通过 HTTPS 提供这些协议之前，不要发布 _a2a._agents 或 _mcp._agents——MCP 服务器是 stdio（npx @aptos-labs/aptos-mcp），不是远程 MCP 端点。

该区域已有 DNSKEY 与 RRSIG 记录，但验证解析器仍返回 AD=0，因为 .dev 父域没有 DS 记录。因此要求 DNSSEC 的智能体扫描器会失败，即使 HTTPS 记录已经发布。运维应在注册商发布 KSK 的 DS 记录（或在 Google Cloud DNS 中启用 DNSSEC，使其自动提交 DS），然后确认：

dig +short HTTPS _index._agents.aptos.dev
dig +dnssec HTTPS _index._agents.aptos.dev
dig DS aptos.dev

若还要通过 DNS 宣告 AI Catalog，请添加：

_catalog._agents.aptos.dev. 3600 IN TXT "url=https://aptos.dev/.well-known/ai-catalog.json"

Markdown 内容协商

任何拥有 .md 镜像的文档 URL（例如 /zh/build/sdks → /zh/build/sdks.md）都会响应 Accept: text/markdown 并返回 Content-Type: text/markdown：

curl -H "Accept: text/markdown" https://aptos.dev/zh/build/sdks

浏览器的默认 Accept: text/html 依旧得到 HTML 响应。

WebMCP

在实现 WebMCP 提案 的浏览器（如 Chrome 早期预览）中，每个文档页面会通过 navigator.modelContext 暴露以下工具：aptos-docs.search、aptos-docs.open-doc、aptos-docs.fetch-doc-markdown 与 aptos-docs.list-llms-feeds。