在 Web3 世界，波卡（Polkadot）一直以技术硬核著称。从 XCM 跨链消息传递的复杂逻辑，到 OpenGov 多轨道治理的决策机制，开发者在构建时往往需要面对实时更新、体量庞大的官方文档。

近日，波卡官方宣布推出 Polkadot Documentation MCP 服务器。这不仅仅是一个文档查询工具，而是波卡迈向 “AI 驱动开发” 时代的关键一步。

从此，在 Polkadot 生态上构建项目，你将拥有一位随时待命、直连官方文档的 AI 专家在你身边。

什么是 MCP？

模型上下文协议（Model Context Protocol，MCP）是由 Anthropic 提出的开放标准，它允许 AI 客户端（如 Claude Desktop、Cursor、IDE）通过统一的接口实时访问外部数据源、工具和文档。

你可以把 MCP 想象为 AI 的 “USB-C 接口”：它为 AI 提供了一种标准化方式，连接到外部系统，从而获得最新、权威的信息。

MCP 的核心优势在于：

• 对开发者：减少在构建 AI 应用或代理时的开发时间和复杂性；

• 对 AI 应用或代理：提供对数据源、工具和应用生态的访问，提高功能和智能化水平；

• 对用户：提升 AI 应用的能力，在需要时代理用户获取信息或执行任务。

Polkadot MCP 服务器：你的官方专家助手

波卡推出的 MCP 服务器将官方文档库直接转换成了 AI 可理解的实时索引。

连接后，你可以直接向 AI 提出那些过去需要在文档、论坛之间反复翻找才能得到答案的问题，例如：

• XCM 费用是如何计算的？

• 我的治理提案属于 OpenGov 的哪个 Track？

• 如何对自定义 Pallet 进行性能基准测试（benchmark）？

• EVM 与 PolkaVM 有什么本质区别？

• 如何逐步配置一个验证节点？

• 如何在 Asset Hub 上注册外部资产？

支持的接入方式也覆盖了主流开发场景：IDE 方面支持 Cursor 和 VS Code 一键安装；桌面客户端兼容 Claude 和 ChatGPT；命令行用户可使用 Claude Code CLI 或 Codex CLI 完成配置。

不止 Q&A：面向 AI 工程师的结构化资源

对于希望构建自己的 AI Agent 或 RAG（检索增强生成）管道的开发者，官方文档同步以结构化的 LLM 友好格式全面开放。

具体包含以下几类文件：

• llms.txt：文档页面的 Markdown URL 索引，适合为模型提供站点的高层次导航地图；

• site-index.json：轻量级站点索引，包含每页元数据与内容预览，适合上下文窗口较小的场景；

• llms-full.jsonl：完整文档内容，附带元数据增强，适合大上下文模型或构建 RAG 管道。

在这种流程下，AI Agent 可以在需要时直接查询文档、获取最新 API 改动、最后完成自我修复，整个过程无需人工干预。

九大主题文件

除全站文件外，官方还提供了按主题分类的聚焦文件包，共分为九大类别，每类均有完整版（Full Bundle）与轻量版（Lightweight Index）两个版本供选取：

1️⃣ Basics（基础知识）

Polkadot 概览、核心概念与面向新开发者的入门指南。

2️⃣ Smart Contracts（智能合约）

使用 Solidity、EVM、PolkaVM 以及 Hardhat、Foundry 等工具在 Polkadot Hub 上开发和部署智能合约

3️⃣ Parachains（平行链）

使用 Polkadot SDK 构建和部署平行链，包括 Runtime 开发、Pallet 开发与 Coretime。

4️⃣ Chain Interactions（链交互）

查询链上数据、发送交易、跨链通信以及在 Polkadot 系链上管理代币与账户。

5️⃣ Interoperability（互操作性）

通过 XCM 实现跨链通信、资产转移、HRMP 通道管理以及与外部网络的桥接。

6️⃣ Infrastructure（基础设施）

运行验证节点、收集节点与 RPC 节点，以及质押机制与密钥管理。

7️⃣ Polkadot Protocol（Polkadot 协议）

协议内部机制，涵盖共识、Coretime、区块生产、密码学与链架构。

8️⃣ Tooling（工具链）

开发者 SDK 与工具，包括 PAPI、Polkadot.js、subxt、轻客户端与测试框架。

9️⃣ Reference（参考资料）

术语表、治理结构、OpenGov Origin Tracks 与技术规格说明。

以 Claude 为例：手把手安装 Polkadot MCP 服务器

以下以 Claude 网页版为例，完整演示如何将 Polkadot 官方 MCP 服务器接入你的 AI 工具。整个过程无需任何代码，5 分钟内可完成。

⚠️ 注：Cursor、VS Code、ChatGPT 等其他客户端的安装方式，请参阅 docs.polkadot.com/ai-resources/#connect-via-mcp。

第一步：进入 Connectors 设置页面

打开 claude.ai 并登录，点击左下角的个人头像，从下拉菜单中选择 "Settings"。在左侧侧边栏找到 "Connectors" 并点击，即可看到当前已配置的连接器列表。

第二步：添加自定义连接器

在 Connectors 页面底部，找到 "Add custom connector" 按钮并点击。此时会弹出一个对话框，提示你输入远程 MCP 服务器的 URL。

在输入框中填入 Polkadot 官方 MCP 服务器地址：

https://docs-mcp.polkadot.com

确认地址无误后，点击 "Add" 继续。

第三步：完成身份验证（如有）

大多数远程 MCP 服务器需要身份验证，常见形式包括 OAuth、API 密钥或用户名密码组合，按提示操作即可。

Polkadot 官方文档 MCP 服务器为公开只读服务，通常无需额外授权，直接连接即可。

第四步：在对话中使用文档资源

连接成功后，在 Claude 消息输入框中点击 ➕ 图标，即可打开附件菜单，选择已连接服务器的资源作为上下文加入对话。

此后直接提问任何 Polkadot 技术问题，Claude 将实时从官方文档中检索内容作答，无需手动粘贴文档片段。

图：Claude 消息框示例

第五步：管理工具权限（可选）

在 Connectors 设置点击已连接的服务器，可以启用或禁用特定工具、设置使用限制及其他安全参数，确保 Claude 只执行你明确授权的操作。

👉 完成以上步骤，你的 Claude 就拥有了 “随叫随到的 Polkadot 官方专家”，可以在开发、测试和部署中提供即时帮助。

打破门槛，拥抱波卡速度

长期以来，Polkadot 的复杂架构（中继链、平行链、XCM、Coretime、OpenGov）对于新手开发者而言，学习曲线相当陡峭。

但通过 MCP 服务器，波卡正在主动拆除这些围墙，为开发者修筑了一条通往 AI 时代的 “高速公路”。

开发者不再需要死记复杂指令，而是可以通过 AI 直接访问权威信息，高效构建 Polkadot 应用。现在快来试试吧！

相关链接：

• 波卡 MCP 资源页面：https://docs.polkadot.com/ai-resources/

• Model Context Protocol 官方文档：https://modelcontextprotocol.io