GoldRush MCP 技能

使用此技能，可通过 uxc 以固定 stdio 端点方式运行 GoldRush MCP 操作。

复用 uxc 技能实现通用协议发现、输出解析，以及认证/错误处理规则。

前提条件

• uxc 已安装并位于 PATH 中。
• npx 可用（即已安装 Node.js）。
• 首次获取 @covalenthq/goldrush-mcp-server 包时需具备网络访问能力。
• 已获取有效的 GoldRush API 密钥。

核心工作流

在最终确定前，候选端点输入如下：

• 文档中提供的原始包形式：npx @covalenthq/goldrush-mcp-server@latest
• 可靠且非交互式的形式：npx -y @covalenthq/goldrush-mcp-server@latest
• 本技能默认采用：
  • npx -y @covalenthq/goldrush-mcp-server@latest

1. 从官方来源验证协议/路径并进行探测：
   • 官方来源：https://goldrush.dev/docs/goldrush-mcp-server
   • 使用以下命令探测候选端点：
     • uxc --inject-env GOLDRUSH_API_KEY=$GOLDRUSH_API_KEY "npx -y @covalenthq/goldrush-mcp-server@latest" -h
   • 冷启动在首次运行时可能耗时更长，因为 npx 可能需要下载该包
2. 配置凭证以支持可重复的身份认证：
   • uxc auth credential set goldrush-mcp --auth-type bearer --secret-env GOLDRUSH_API_KEY
   • uxc auth credential set goldrush-mcp --auth-type bearer --secret-op op://Engineering/goldrush/api-key
3. 默认使用固定链接命令：
   • command -v goldrush-mcp-cli
   • 若未找到，创建该链接：
     • uxc link goldrush-mcp-cli "npx -y @covalenthq/goldrush-mcp-server@latest" --credential goldrush-mcp --inject-env GOLDRUSH_API_KEY={{secret}}
   • goldrush-mcp-cli -h
4. 执行前检查操作的 Schema：
   • goldrush-mcp-cli getAllChains -h
   • goldrush-mcp-cli multichain_balances -h
   • goldrush-mcp-cli transactions_for_address -h
   • goldrush-mcp-cli historical_portfolio_value -h
5. 优先执行只读型发现操作，再逐步扩展至更广泛的地址历史或 NFT 扫描。

能力映射表

• 跨链概览：
  • getAllChains
  • multichain_address_activity
  • multichain_balances
  • multichain_transactions
• 钱包余额与投资组合：
  • token_balances
  • historical_token_balances
  • native_token_balance
  • historical_portfolio_value
  • historical_token_prices
• 转账与交易：
  • erc20_token_transfers
  • transaction
  • transaction_summary
  • transactions_for_address
  • transactions_for_block
• NFT 与安全相关：
  • nft_for_address
  • nft_check_ownership
  • token_approvals
• 工具类功能：
  • gas_prices
  • log_events_by_address
  • log_events_by_topic
  • block
  • block_heights

GoldRush 还提供若干 MCP 资源，例如 config://supported-chains、config://quote-currencies 和 status://all-chains。完成认证配置后，请检查正在运行的服务端，以获取当前完整的工具与资源列表。

推荐使用模式

1. 从一个明确的只读目标开始：
   • 某钱包的跨链余额
   • 某地址的近期转账记录
   • 随时间变化的历史投资组合价值
   • NFT 所有权或代币授权审批审查
2. 首次真实调用前，先对特定工具执行 -h 查看帮助信息。
3. 优先针对单个钱包和单条链执行操作，再扩展为全量历史扫描。
4. 先解析 JSON 封套（envelope），再检查其中的 data 字段。

防护机制（Guardrails）

• 自动化逻辑应始终基于 JSON 输出封套，切勿依赖 --text 格式输出。
• 优先解析稳定字段：ok、kind、protocol、data、error。
• 默认使用 goldrush-mcp-cli 作为命令路径。
• 当按上述方式创建链接后，goldrush-mcp-cli ... 等价于：
  uxc --auth goldrush-mcp --inject-env GOLDRUSH_API_KEY={{secret}} "npx -y @covalenthq/goldrush-mcp-server@latest" ...
• GoldRush 使用通过 npx 启动的 stdio 类型 MCP 服务端，而非托管式 HTTPS MCP 端点。首次运行时冷启动将较慢。
• 若帮助信息或首次调用在初始化阶段超时：
  • 待包下载完成后重试相同命令
  • 确认 npx 已加入 PATH
  • 确认密钥已作为环境变量 GOLDRUSH_API_KEY 正确注入
• 本技能文档中仅将 Bearer 凭证存储用作 --inject-env 的密钥容器；GoldRush 实际认证机制是通过子进程的环境变量完成，而非 HTTP Bearer 请求头。
• 由于部分工具可能返回大量结果，建议优先执行钱包范围内的读取操作，再开展大范围交易或日志扫描。
• 请勿凭记忆假设工具参数名称；务必先执行 -h 查看最新定义，因 GoldRush 可能独立于本技能更新其 MCP Schema。

参考文档

• 调用模式：
  • references/usage-patterns.md