用途
Solana MCP by Vybe 提供一个公开的 Model Context Protocol（MCP）服务器，使 Claude Desktop、Cursor、VS Code 及其他 MCP 客户端能够与 Solana 区块链交互。它通过位于 https://mcp.vybenetwork.xyz 的标准化 MCP 接口，暴露 Solana RPC 方法、SPL 代币查询、Token-2022 操作和账户查询。AI 智能体无需编写自定义 Solana 集成代码，即可连接该 MCP 服务器，直接查询余额、交易历史、代币元数据、NFT，并对 Solana 主网/开发网执行读取操作。
主要能力
服务器将 Solana RPC 方法暴露为 MCP 工具，常见操作包括：
账户操作：获取账户余额（SOL）、获取账户信息与数据、按所有者查询代币账户、获取程序账户。
代币操作：获取 SPL 代币余额、查询代币元数据、列出代币账户、支持 Token-2022 扩展。
交易操作：获取交易详情、查询交易历史、检查交易状态。
区块链查询：获取区块信息、查询 slot/epoch 数据、网络状态。
使用方式
Cursor 配置
添加到 Cursor MCP 配置文件（~/.cursor/mcp.json 或工作区 .cursor/mcp.json）：
{ "mcpServers": { "solana-vybe": { "url": "https://mcp.vybenetwork.xyz" } } }
认证通过 MCP 宿主的客户端 OAuth 流程完成。
Claude Desktop 配置
添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：
{ "mcpServers": { "solana-vybe": { "command": "npx", "args": [ "mcp-remote", "https://mcp.vybenetwork.xyz" ] } } }
VS Code 配合 Cline/Roo-Cline
添加到 MCP 设置：
{ "solana-vybe": { "url": "https://mcp.vybenetwork.xyz" } }
验证连接
配置完成后重启 MCP 客户端，Solana MCP 工具应出现在客户端的工具/资源列表中。可检查以下工具：solana_get_account_info、solana_get_balance、solana_get_token_accounts、solana_get_transaction。
使用示例
查询 SOL 余额：向 AI 智能体提问“地址 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU 的 SOL 余额是多少？”，智能体将调用 solana_get_balance 工具，参数为 {"address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "network": "mainnet-beta"}。
获取代币账户：提问“显示 CuieVDEDtLo7FypA9SbLM9saXFdb1dsshEkyErMqkRQq 拥有的所有 SPL 代币账户”，智能体使用 solana_get_token_accounts，参数为 {"owner": "CuieVDEDtLo7FypA9SbLM9saXFdb1dsshEkyErMqkRQq", "network": "mainnet-beta"}。
获取交易详情：提问“获取交易 5wHu1qwD7q5ifaN5nwdcDqNFo53GJqa7nLp2BeeEpcnkKoLkJGNK3omvLsEvVpHndv2QgHCzZQmAy6Qx8NXKvPRQ 的详情”，智能体调用 solana_get_transaction。
查询代币元数据：提问“代币 mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v 的元数据是什么？”，智能体使用 solana_get_token_metadata。
切换网络：所有工具支持 network 参数，可选 mainnet-beta（默认）、devnet、testnet。
适用场景
构建代币投资组合查看器：先获取 SOL 余额，再获取所有代币账户，然后为每个代币获取元数据以显示名称、符号和余额。
交易历史分析：获取地址的近期交易签名，再逐一获取交易详情以解析转账和程序交互。
NFT 集合查询：获取代币账户后筛选 NFT（amount = 1，decimals = 0），再获取每个 NFT mint 的元数据（包含名称、图片 URI、属性）。
配置与限制
网络选择：始终在工具调用中指定 network 参数。
认证：公开 MCP 服务器使用由 MCP 客户端管理的 OAuth 认证，无需在配置文件中存储 API 密钥。首次连接时客户端会提示 OAuth 授权。
速率限制：公开服务器存在速率限制。生产应用如需高吞吐量，可联系 Vybe Network 获取企业访问权限、考虑托管私有实例，或在智能体逻辑中实现请求批处理。
环境变量：如需覆盖默认端点（例如用于测试），可设置 export VYBE_MCP_URL="https://custom-mcp.example.com"，然后在配置中引用 {"url": "$VYBE_MCP_URL"}。
故障排查
连接被拒绝：检查网络连通性（curl https://mcp.vybenetwork.xyz）、验证 MCP 配置语法（有效 JSON）、配置更改后重启 MCP 客户端、检查客户端日志中的 OAuth 错误。
工具未找到：确认 MCP 服务器已连接、在客户端 MCP 检查器中列出可用工具、验证使用正确的工具名称（snake_case）、重启客户端刷新工具注册表。
认证错误：完成客户端中的 OAuth 流程、检查 OAuth 令牌是否过期（重新认证）、对于组织仓库授予 OAuth 应用对 vybenetwork 组织的访问权限、如使用企业 GitHub 验证 SAML/SSO 合规性。
无效地址/签名：验证 Solana 地址为有效 base58、检查地址长度（通常 32-44 字符）、确保交易签名为有效 base58（87-88 字符）、不要混淆主网/开发网地址。
网络超时：检查 Solana 网络状态、使用指数退避重试、减少并发请求（速率限制）、如主网拥堵可切换到开发网。
代币元数据缺失：并非所有代币都有元数据（尤其是较旧的 SPL 代币）、检查 mint 地址是否正确、验证代币是否使用 Metaplex 标准、可直接查询链上账户数据作为回退。
高级用法
使用程序过滤器自定义查询：调用 solana_get_program_accounts，传入 programId 和 filters（如 memcmp 偏移与字节）。
区块浏览器集成：从交易签名构建区块浏览器 URL，如 https://explorer.solana.com/tx/${signature} 或 https://solscan.io/tx/${signature}。
资源
文档：docs.vybenetwork.com/docs/mcp
MCP 端点：https://mcp.vybenetwork.xyz
注册表：registry.modelcontextprotocol.io
GitHub：github.com/vybenetwork/solana-mcp-vybe
示例智能体提示
“最新区块中 SOL 的当前价格是多少？”
“显示地址 X 的前 5 个代币持仓”
“分析此 NFT mint 的交易历史”
“比较此钱包在主网和开发网上的代币余额”
“列出所有启用了转账费用的 Token-2022 账户”
“此交易与哪些程序进行了交互？”