使用说明

项目简介

Realtime Crypto MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,专注于提供实时的加密货币市场数据。它通过集成 CoinCap API,为大型语言模型 (LLM) 应用提供最新的加密货币交易所信息和实时汇率。该服务器实现了 MCP 协议,可以作为 LLM 应用的上下文数据源,增强 LLM 在金融和加密货币领域的应用能力。

主要功能点

  • 交易所信息查询: 提供加密货币交易所的详细信息,包括交易量、排名、交易对、网站链接等。
  • 实时汇率查询: 获取多种加密货币的当前美元汇率。
  • 数据来源可靠: 使用 CoinCap API 作为数据源,保证数据的实时性和准确性。
  • 速率限制处理: 内置速率限制和重试机制,应对 CoinCap API 的访问限制,保证服务的稳定性。
  • 易于集成: 遵循 MCP 协议,可以方便地与任何兼容 MCP 协议的 LLM 客户端集成。

安装步骤

  1. 安装 Node.js: 确保你的环境中已安装 Node.js 18 或更高版本。
  2. 克隆仓库: 将仓库克隆到本地:
    git clone https://github.com/smhnkmr/realtime-crypto-mcp-server.git
  3. 进入仓库目录:
    cd realtime-crypto-mcp-server
  4. 安装依赖:
    npm install
  5. 构建项目:
    npm run build

服务器配置

为了让 MCP 客户端能够连接到 Realtime Crypto MCP Server,需要在客户端的配置文件中添加以下服务器配置信息。这是一个 JSON 格式的配置示例,你需要将其添加到你的 MCP 客户端配置中:

{
  "mcpServers": {
    "realtime-crypto": {
      "command": "npx",
      "args": ["realtime-crypto-mcp-server"]
    }
  }
}

配置参数说明:

  • 'mcpServers': 这是配置 MCP 服务器的顶级字段,客户端通过这个字段来管理和配置多个 MCP 服务器。
  • 'realtime-crypto': 这是一个自定义的服务器名称,你可以根据需要修改,用于在 MCP 客户端中唯一标识和引用这个服务器。
  • 'command': 这是启动 MCP 服务器的命令。这里 'npx' 是 Node.js 包执行器,用于执行本地安装或全局安装的 npm 包。 'realtime-crypto-mcp-server' 是 package.json 中定义的 "name" 字段,npx 会自动查找并执行该包的入口文件 (通常在 package.json 的 "bin" 或 "main" 字段中指定)。
  • 'args': 这是一个字符串数组,用于传递给启动命令的参数。 在这个配置中,'args' 数组为空,表示启动 'realtime-crypto-mcp-server' 命令时不需要额外的命令行参数。

注意: 请确保你的 MCP 客户端能够正确解析和加载这个 JSON 配置文件。

基本使用方法

  1. 启动服务器: 在仓库根目录下,运行以下命令启动服务器:

    npm start

    服务器将通过 stdio 传输协议运行,并在终端输出 "Realtime Crypto MCP Server running on stdio"。

  2. 配置 MCP 客户端: 根据上述 "服务器配置" 部分的说明,配置你的 MCP 客户端,使其能够连接到 Realtime Crypto MCP Server。

  3. 调用工具: 在 MCP 客户端中,你可以通过以下工具来获取数据:

    • 'get-exchange-details': 获取交易所详细信息。需要提供 'exchange' 参数,例如 '{"exchange": "binance"}'。
    • 'get-rates': 获取加密货币汇率。需要提供 'currency' 参数,例如 '{"currency": "bitcoin"}'。

    客户端根据 MCP 协议向服务器发送请求,服务器处理请求并返回包含加密货币数据的 JSON-RPC 响应。

通过以上步骤,你就可以将 Realtime Crypto MCP Server 集成到你的 LLM 应用中,为 LLM 提供实时的加密货币市场数据支持。

信息

分类

网页与API