跳转到主要内容
AI本地开发:Helius MCP服务器为AI工具提供对我们文档和API规范的直接访问,实现上下文代码生成和智能辅助。

什么是MCP?

模型上下文协议(MCP)是一个开放标准,用于在AI应用程序和外部服务(如文档)之间创建标准化连接。Helius MCP服务器自动为AI应用程序提供工具,以搜索我们的文档并与我们的API进行交互。

实时上下文

AI工具可以搜索实时文档和API规范,以获取准确、最新的信息

代码生成

AI使用当前API方法和我们文档中的最佳实践生成可用的代码示例

交互式开发

提出关于Helius API的问题,并根据我们的文档获得上下文答案

无缝集成

适用于流行的AI驱动IDE和开发工具

Helius MCP的工作原理

Helius MCP服务器自动生成并托管在https://www.helius.dev/docs/mcp,为AI工具提供访问:
  • 完整的API文档:所有Helius API方法、参数和示例
  • 搜索功能:查询我们文档中的任何部分以获取特定信息
  • 代码示例:常用案例的工作实现
  • 最佳实践:使用Helius服务的推荐模式
  • 实时更新:始终与最新的文档变化保持一致
自动生成:我们的MCP服务器根据我们的文档和API规范自动生成,确保始终与最新功能和变化保持同步。

入门

1

选择您的 AI 工具

确保您的 AI 工具支持 MCP。流行的选项包括:
  • Cursor:内置 MCP 支持
  • Windsurf:原生 MCP 集成
  • Claude Desktop:MCP 服务器支持
  • VS Code:通过 MCP 扩展
2

连接到 Helius MCP 服务器

将 Helius MCP 服务器 URL 添加到您的 AI 工具中:
https://www.helius.dev/docs/mcp
每个工具都有不同的配置方法 - 请参阅下文中的具体说明。
3

开始使用具有 Helius 上下文的 AI

一旦连接,开始就 Helius APIs 提问。AI 会自动搜索我们的 MCP 服务器,以获取准确的上下文文档来帮助生成代码。

连接说明

选择您的 AI 工具并按照具体的设置说明执行:
  1. 打开 Cursor IDE
  2. 使用上下文菜单(见下文)或手动添加 MCP 服务器:
    • 打开 Settings → MCP Servers
    • 添加服务器 URL: https://www.helius.dev/docs/mcp
  3. 开启 Agent 模式 (Ctrl/Cmd + K)
  4. 询问:“使用 Helius TypeScript SDK 编写发送交易的脚本”
  5. AI 将通过 MCP 搜索我们的文档以生成准确的代码

上下文菜单集成

为了快速访问,请使用在我们文档的任何页面上可用的上下文菜单:
  • 复制 MCP 服务器 URL:将 https://www.helius.dev/docs/mcp 复制到剪贴板
  • 连接到 Cursor:自动在 Cursor 中安装 MCP 服务器
  • 连接到 VS Code:自动在 VS Code 中安装 MCP 服务器
上下文菜单提供了连接到我们的 MCP 服务器的最简单方法。请在任何文档页面的右上角查找菜单图标。

MCP 技能

Helius MCP 服务器提供特定产品技能的访问。每个技能为不同的 Helius 产品提供专门的能力。 查看完整MCP 技能索引以获取所有可用技能。

使用案例

场景:您需要快速构建一个获取 NFT 数据并显示其的演示。使用 MCP:询问您的 AI 工具”创建一个 React 组件,使用 Helius DAS API 获取并显示钱包的 NFTs”结果:获取一个完整的组件,具有适当的错误处理、加载状态和当前 API 使用。
场景:将 Helius websockets 集成到您的应用程序中。使用 MCP:“展示如何设置 Helius websockets 以监控帐户更改”结果:完整的 websocket 设置代码,具有适当的连接处理和实时更新。
场景:需要为您的团队记录 Helius 集成。使用 MCP:“生成我们的 Helius RPC 使用模式文档”结果:包含代码示例和最佳实践的全面文档。
场景:您的 Helius API 调用失败或性能不佳。使用 MCP:“帮助我优化这些 Helius API 调用并正确处理错误”结果:改进的代码具有适当的错误处理和性能优化。

示例工作流

构建交易监控器

// Ask your AI: "Create a transaction monitor using Helius websockets"
// The AI will generate something like this with current API patterns:

const WebSocket = require('ws');

// Create WebSocket connection
const ws = new WebSocket('wss://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY');

ws.on('open', function open() {
  console.log('WebSocket connected');

  // Subscribe to account changes
  const request = {
    jsonrpc: "2.0",
    id: 1,
    method: "accountSubscribe",
    params: [
      "YOUR_WALLET_ADDRESS",
      {
        encoding: "jsonParsed",
        commitment: "confirmed"
      }
    ]
  };

  ws.send(JSON.stringify(request));
});

ws.on('message', function incoming(data) {
  const message = JSON.parse(data.toString());
  console.log('Account update:', message);
});

NFT 投资组合追踪器

// Ask: "Build an NFT portfolio tracker using Helius DAS API"
// Get working code with current method signatures:

const getNFTPortfolio = async (walletAddress: string) => {
  const response = await fetch(`https://mainnet.helius-rpc.com/?api-key=${API_KEY}`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: 'my-id',
      method: 'getAssetsByOwner',
      params: {
        ownerAddress: walletAddress,
        page: 1,
        limit: 1000
      },
    }),
  });

  const data = await response.json();
  return data.result;
};

高级功能

MCP 服务器提供文档上下文,使 AI 工具可以做出智能建议:
  • API 方法选择:AI 根据我们的文档推荐最合适的 Helius API
  • 错误处理:AI 从我们的文档中建议正确的错误处理模式
  • 性能提示:AI 使用我们的最佳实践识别优化机会

支持的 AI 工具

工具支持级别设置难度最佳用途
Cursor原生简单全栈开发
Windsurf原生简单AI 辅助编码
Claude Desktop支持中等文档和规划
VS Code需要扩展中等现有 VS Code 工作流

最佳实践

具体问题

提出具体问题,例如“如何分页获取NFT结果?”而不是“需要NFT帮助”

包含上下文

提及你的技术栈:“使用Next.js和TypeScript,告诉我如何……”

快速迭代

用生成的代码作为起点并请求修改

测试生成的代码

始终在你的开发环境中测试AI生成的代码

疑难解答

问题:AI工具无法连接到Helius MCP服务器解决方案
  1. 验证MCP服务器URL是否正确:https://www.helius.dev/docs/mcp
  2. 检查你的互联网连接
  3. 重启AI工具并尝试重新连接
  4. 确保你的AI工具支持MCP(查看工具文档)
问题:只有搜索工具出现,没有API端点解决方案
  1. 这是预期的行为 - 我们的MCP服务器提供文档搜索功能
  2. 当AI需要具体信息时,API端点可通过搜索工具访问
  3. 搜索工具提供所有文档和API规范的访问
问题:AI提供了过时的API信息解决方案
  1. MCP服务器会自动更新我们的文档
  2. 刷新你的AI会话或重启工具
  3. 专门请求“最新”API信息
  4. 验证你连接的是正确的MCP服务器URL
问题:AI生成的代码有错误或无法运行解决方案
  1. 与AI共享错误信息以进行调试
  2. 请求AI搜索特定的错误处理模式
  3. 验证你的API密钥和网络连接
  4. 从我们的文档中请求工作示例
问题: 无法找到或使用上下文菜单解决方案:
  1. 查找文档页面右上角的菜单图标
  2. 确保您在受支持的浏览器中查看文档
  3. 手动复制 MCP 服务器 URL: https://www.helius.dev/docs/mcp
  4. 使用上述连接说明手动配置您的 AI 工具

了解更多