# @covalenthq/goldrush-mcp-server 中文文档

规范地址：https://npmcn.com/package/%40covalenthq/goldrush-mcp-server/

版本：3\.0\.9
npm 元数据更新时间：2026-10-29T04:23:10.126Z
中文译文更新时间：2026-11-11T01:23:30.861Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40covalenthq/goldrush-mcp-server
原文对照：https://npmcn.com/package/%40covalenthq/goldrush-mcp-server/?lang=original
项目主页：https://goldrush.dev/docs/
源码仓库：https://github.com/covalenthq/goldrush-services-monorepo

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.2 MB，259 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：6 个
- 首次发布：2025-04-28T21:27:22.065Z
- 最新版本发布：2026-10-29T04:23:09.922Z
- 近 30 天下载量：2276（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 10 个）

## 中文简介

GoldRush 磁共振 用于与 Covalent GoldRush API 交互的服务器

## 安装

```sh
npm install @covalenthq/goldrush-mcp-server
```

也可以使用：`pnpm add @covalenthq/goldrush-mcp-server`、`yarn add @covalenthq/goldrush-mcp-server`、`bun add @covalenthq/goldrush-mcp-server`

## README

# GoldRush MCP 服务器

[![npm version](https://img.shields.io/npm/v/@covalenthq/goldrush-mcp-server.svg)](https://www.npmjs.com/package/@covalenthq/goldrush-mcp-server) [![npm downloads](https://img.shields.io/npm/dm/@covalenthq/goldrush-mcp-server.svg)](https://www.npmjs.com/package/@covalenthq/goldrush-mcp-server) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

A 类 [示范背景协议](https://modelcontextprotocol.io/) 提供 AI 代理和 LLMS 的服务器 直接访问横跨100+链的区块链数据,由 [高德鲁什 API](https://goldrush.dev/)钱包代号余额、交易历史、NFT持有量、, 历史价格,符号批准 和跨链活动, 所有作为 MCP 工具 您的模型可以调用.

Claude Desktop, Claude Code, Cursor, Windsurf, Cline 以及其他MCP客户端的工作.

-   **网站:** [金笔. dev](https://goldrush.dev/)
-   **联合国** [GoldRush MCP 磁共振 服务器文件](https://goldrush.dev/docs/goldrush-mcp-server)
-   **API 参考 :** [goldrush.dev/docs (中文(简体) )](https://goldrush.dev/docs/)
-   **获取 API 密钥 :** [免费报名](https://goldrush.dev/platform/auth/register/)

## 快开始

获取免费 API 密钥 [金笔. dev](https://goldrush.dev/platform/auth/register/),然后添加 服务器到您的 MCP 客户端配置 .

### 克劳德桌面

添加为 `claude_desktop_config.json`数字 :

```json
{
    "mcpServers": {
        "goldrush": {
            "command": "npx",
            "args": ["-y", "@covalenthq/goldrush-mcp-server@latest"],
            "env": {
                "GOLDRUSH_API_KEY": "your-api-key-here"
            }
        }
    }
}
```

### 克劳德代码

```bash
claude mcp add goldrush -e GOLDRUSH_API_KEY=your-api-key-here \
  -- npx -y @covalenthq/goldrush-mcp-server@latest
```

### 光标/ 微风突起

添加同样的 `mcpServers` 块到 `.cursor/mcp.json` 或者说 `~/.codeium/windsurf/mcp_config.json`。 。 。 .

### 全球安装

```bash
npm install -g @covalenthq/goldrush-mcp-server
GOLDRUSH_API_KEY=your-api-key-here goldrush-mcp-server
```

一旦连接起来,就问问你的模特儿 比如"什么是标志是什么","他持有在基地?" "给我看NFT的收藏 在这钱包中 跨越每一个链".

## 工具

服务器注册了28个由GoldRush API支持的块链数据工具,加上9个协议 goldRush语义层上的分析工具.

### 钱包余额

| 工具 | 目的 |
| --- | --- |
| `token_balances` | 地址当前 ERC20 和本地符号余额 |
| `historical_token_balances` | 截至过去日期或区块的库存余额 |
| `historical_portfolio_value` | 地址的长期组合值 |
| `erc20_token_transfers` | 地址的 ERC20 传输历史 |
| `token_holders` | 任何街区高度的标志物的持有者 |
| `native_token_balance` | 地址的原生气体代号余额 |

### 交易

| 工具 | 目的 |
| --- | --- |
| `transaction` | 一个有解码日志事件的交易 |
| `transaction_summary` | 地址的最新和总交易数 |
| `transactions_for_address` | 地址的刻入交易历史 |
| `transactions_for_block` | 区块中的每笔交易 |

### 跨链

| 工具 | 目的 |
| --- | --- |
| `multichain_balances` | 在一个呼叫中,在多个链条的地址上保持平衡 |
| `multichain_transactions` | 跨越许多链条的地址交易 |
| `multichain_address_activity` | 一个地址的链条已激活到 |

### 无

| 工具 | 目的 |
| --- | --- |
| `nft_for_address` | NFT 钱包持有, 有元数据 |
| `nft_check_ownership` | 地址是否包含收藏中的任何内容 |
| `nft_check_ownership_token_id` | 地址是否持有特定代号ID |

### 定价

| 工具 | 目的 |
| --- | --- |
| `historical_token_prices` | 象征物的历史现货价格 |
| `pool_spot_prices` | DEX 集合的现时价格 |

### 警卫

| 工具 | 目的 |
| --- | --- |
| `token_approvals` | 未完成的ERC20地址核准,有风险分数 |

### 链和块原始人

| 工具 | 目的 |
| --- | --- |
| `gas_prices` | 链条目前的天然气价格 |
| `block` | 单块 |
| `block_heights` | 日期范围内的块高 |
| `log_events_by_address` | 合同所排放的解码日志事件 |
| `log_events_by_topic` | 匹配主题散列的已解码日志事件 |
| `resolve_address` | 解析一个 ENS 或类似的名称到地址 |

### 比特币

| 工具 | 目的 |
| --- | --- |
| `bitcoin_hd_wallet_balances` | HD 钱包地址的余额 |
| `bitcoin_non_hd_wallet_balances` | 单个比特币地址的余额 |
| `bitcoin_transactions` | 比特币地址的交易历史 |

### 协议分析

`list_entities`, (中文(简体) ), `search_catalog`, (中文(简体) ), `get_metadata`, (中文(简体) ), `list_members`, (中文(简体) ), `get_metric`, (中文(简体) ), `get_metrics`, (中文(简体) ), `get_breakdown`, (中文(简体) ), `compare_entities`, (中文(简体) ), `rank_entities`: 只读分析 在GoldRush仓库上 穿过它的立方体语义层.

他们在这个服务器中运行对Cube,所以需要下面的Cube变量. 无 分析工具找不到数据集(`list_entities` 报告 `semantic_source: "unavailable"`) (中文(简体) ).

## 资源

| URI 资源 | 目录 |
| --- | --- |
| `config://supported-chains` | GoldRush API 支持的每个链条 |
| `config://quote-currencies` | 价格字段的有效引号货币 |
| `status://all-chains` | 所有链条的同步状态 |
| `status://chain/{chainName}` | 一个链的同步状态 |

见 [完整网络列表](https://goldrush.dev/docs/chains/overview) 用于链条名称.

## 配置

### 环境变量

| 变量 | 需求 | 目的 |
| --- | --- | --- |
| `GOLDRUSH_API_KEY` | 对 | 您的 GoldRush API 密钥 |
| `CUBE_API_URL`, (中文(简体) ), `CUBE_API_TOKEN` | 为了分析 | 立方体 分析工具查询( 每个环境都一样) |
| `CUBE_META_URL`, (中文(简体) ), `CUBE_META_API_TOKEN` | 没有 | 单独的立方体 `/meta`; 查询 Cube 默认值 |
| `SEMANTIC_META_TTL_MS` | 没有 | 多长时间 `/meta` 正在重新检查( 默认为 10 分钟) |

### 命令行旗

| 旗帜 | 默认 | 目的 |
| --- | --- | --- |
| `--transport <stdio|http>` | `stdio` | 运输服务 |
| `--port <number>` | `3000` | HTTP 运输端口 |
| `--api-key <key>` |  | API 密钥, 作为环境变量的替代品 |

多数MCP客户端在stdio上生成服务器,这是默认. HTTP运输服务 可流 HTTP 打开 `/mcp` 用于远程或集装箱部署:

```bash
goldrush-mcp-server --transport http --port 3000
```

## 所需资源

-   节点.js 18或更新
-   一个 GoldRush API 密钥 ([免费等级](https://goldrush.dev/pricing)(中文(简体) )

## 链接

-   [黄金冲](https://goldrush.dev/)
-   [MCP 服务器文档](https://goldrush.dev/docs/goldrush-mcp-server)
-   [GoldRush API 参考文献](https://goldrush.dev/docs/)
-   [支助网络](https://goldrush.dev/docs/chains/overview)
-   [定价](https://goldrush.dev/pricing)
-   [`@covalenthq/client-sdk`](https://www.npmjs.com/package/@covalenthq/client-sdk),此服务器基于 TypeScript SDK
-   [示范背景协议](https://modelcontextprotocol.io/)

## 显示您的支持

如果这个计划能帮助你的话,就给你一个!

## 许可证

这个项目获得了麻省理工学院的许可.

## 常见问题

### @covalenthq/goldrush-mcp-server 是什么？

GoldRush 磁共振 用于与 Covalent GoldRush API 交互的服务器

### 如何安装 @covalenthq/goldrush-mcp-server？

在项目目录运行 npm install @covalenthq/goldrush-mcp-server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 goldrush-mcp-server，可以用 npx goldrush-mcp-server 直接运行。

### @covalenthq/goldrush-mcp-server 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @covalenthq/goldrush-mcp-server 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @covalenthq/goldrush-mcp-server 可以商用吗？

@covalenthq/goldrush-mcp-server 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @covalenthq/goldrush-mcp-server 的下载量有多少？

根据 npm 官方下载统计，@covalenthq/goldrush-mcp-server 在 2026/10/11 – 2026/11/09 这 30 天内被下载 2,276 次，日均约 76 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @covalenthq/goldrush-mcp-server 还在维护吗？

最新版本 3\.0\.9 发布于 2026/10/29（12 天前）；至今共发布 14 个版本，其中过去 12 个月发布了 10 个；首次发布于 2025/04/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。