Goldrush MCP Server

🚀 金色rush模型上下文协议服务器

金色rush MCP（Model Context Protocol）服务器是一款用于连接和管理区块链数据的实用工具。它提供了多个服务模块，可高效处理余额查询、交易分析、NFT数据等各类任务，为区块链数据分析提供有力支持。

🚀 快速开始

金色rush MCP服务器能帮助你轻松连接和管理区块链数据，下面为你介绍详细的使用步骤。

✨ 主要特性

• 提供多个服务模块，可处理余额查询、交易分析、NFT数据等多种任务。
• 模块化设计，便于扩展和维护。

📦 安装指南

先决条件

• Node.js 版本18或更高
• npm、yarn 或 pnpm
• 环境变量 GOLDRUSH_API_KEY，需包含有效的金色rush API密钥

安装步骤

首先，克隆项目仓库：

git clone https://github.com/covalenthq/goldrush-mcp-server.git
cd goldrush-mcp-server
npm install

然后，进行项目构建：

npm run build

💻 使用示例

启动MCP服务器

# 启动服务器（运行dist/index.js）
npm run start

启动后，MCP服务器将等待MCP客户端的连接。

运行示例客户端

你可以运行示例客户端，该客户端会作为子进程通过STDIO启动服务器：

npm run example

此示例会尝试进行几次Covalent调用并打印响应结果。

运行测试

npm run test

运行该命令将执行整个测试套件，对每个服务的功能进行全面测试。

设置GOLDRUSH_API_KEY

你必须将环境变量 GOLDRUSH_API_KEY 设置为有效的金色rush API密钥。

• 在Linux/macOS上：

export GOLDRUSH_API_KEY=YOUR_KEY_HERE

• 在Windows上：

set GOLDRUSH_API_KEY=YOUR_KEY_HERE

📚 详细文档

文件布局

goldrush-mcp-server
├── src
│   ├── index.ts                 # MCP服务器的主要入口点
│   ├── services/                # 模块化服务实现
│   │   ├── AllChainsService.ts  # 跨链工具
│   │   ├── BalanceService.ts    # 处理余额相关请求的工具
│   │   ├── BaseService.ts       # 基本区块链工具
│   │   ├── BitcoinService.ts    # 特定于比特币的工具
│   │   ├── NftService.ts        # NFT相关的工具
│   │   ├── PricingService.ts    # 处理定价相关请求的工具
│   │   ├── SecurityService.ts   # 安全相关的工具
│   │   └── TransactionService.ts# 处理交易相关请求的工具
│   ├── resources/               # 资源实现
│   │   ├── staticResources.ts   # 静态配置资源
│   │   └── dynamicResources.ts  # 动态链状态资源
│   ├── utils/                   # 工具函数和常量
│   │   ├── constants.ts         # 共享常量
│   │   └── helpers.ts           # 辅助函数
│   └── example-client.ts        # 使用STDIO传输的示例LLM客户端
├── test
│   ├── AllChainsService.test.ts
│   ├── BalanceService.test.ts
│   ├── BaseService.test.ts
│   ├── BitcoinService.test.ts
│   ├── NftService.test.ts
│   ├── PricingService.test.ts
│   ├── Resources.test.ts
│   ├── SecurityService.test.ts
│   └── TransactionService.test.ts
├── eslint.config.mjs            # ESLint配置
├── package.json                 # 项目依赖和脚本
├── package-lock.json            # 依赖管理锁定文件
├── README.md                    # 项目文档
└── dist/                        # 构建输出目录

📄 许可证

文档中未提及许可证相关信息。

贡献指南

• 问题报告：请在GitHub仓库中提交问题。
• 代码贡献：请fork仓库并提交pull request。

其他信息

金色rush MCP服务器是一个开源项目，旨在为区块链数据分析提供支持。更多详细信息请访问 GitHub仓库。