项目简介

本项目是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在为大型语言模型(LLM)提供访问币安交易所比特币市场数据的能力。通过标准化的 MCP 接口,LLM 可以便捷地获取比特币的实时价格、订单簿、交易记录以及历史价格数据,从而增强 LLM 在金融分析和市场监控等方面的应用能力。

主要功能点

  • 实时行情数据: 获取比特币当前价格、24小时涨跌幅、成交量等实时行情信息。
  • 订单簿数据: 查询币安交易所比特币订单簿的最佳买入价和卖出价。
  • 近期交易记录: 获取最近的比特币交易记录,了解市场交易动态。
  • 历史价格数据: 获取可自定义时间间隔的比特币历史价格数据,支持多种K线周期。
  • 实时价格流: 短期订阅比特币实时价格更新,监测市场价格波动。

安装步骤

  1. 克隆仓库

    git clone https://github.com/MilesCool/binance-mcp.git
    cd binance-mcp
  2. 安装依赖

    pnpm install
  3. 构建项目

    pnpm build

服务器配置

为了让 MCP 客户端连接到 Binance Bitcoin MCP Server,您需要配置客户端的服务器连接信息。以下是一个 JSON 格式的配置示例,您需要将其添加到您的 MCP 客户端配置中。

{
  "serverName": "binance-bitcoin-mcp",  // 服务器名称,用于在客户端中标识
  "command": "pnpm",                   // 启动服务器的命令,这里使用 pnpm
  "args": ["start"]                     // 启动命令的参数,这里是 start 脚本
}

配置说明:

  • 'serverName': 服务器的名称,可以自定义,用于在 MCP 客户端中识别和管理不同的 MCP 服务器连接。
  • 'command': 运行 MCP 服务器的命令。本项目使用 'pnpm start' 启动服务器,因此这里配置为 'pnpm'。如果您的环境中使用 'npm',请替换为 'npm'。
  • 'args': 启动命令的参数。'pnpm start' 命令实际执行的是 'package.json' 中定义的 'start' 脚本,因此这里配置为 '["start"]'。

请确保您的 MCP 客户端能够正确解析和使用以上 JSON 配置信息,以便与 Binance Bitcoin MCP Server 建立连接。

基本使用方法

  1. 启动 MCP 服务器

    在仓库根目录下,运行以下命令启动 Binance Bitcoin MCP Server:

    pnpm start
  2. 连接 MCP 客户端

    配置您的 MCP 客户端,使其连接到正在运行的 Binance Bitcoin MCP Server。客户端应使用 Stdio 传输协议与服务器通信。

  3. 通过 LLM 客户端与服务器交互

    连接成功后,您可以使用 MCP 客户端向服务器发送请求,调用可用的工具。以下是一些示例 Prompt,您可以指示 LLM 客户端执行这些 Prompt 来获取数据:

    • "What is the current Bitcoin price and 24-hour change?" (获取当前比特币价格和24小时涨跌幅)
    • "Show me the current spread between bid and ask prices for Bitcoin." (显示比特币当前买卖价差)
    • "Analyze the last 10 Bitcoin trades and identify any patterns." (分析最近10笔比特币交易并识别模式)
    • "Get Bitcoin price history for the last 24 hours and explain the trend." (获取过去24小时的比特币价格历史并解释趋势)
    • "Watch real-time Bitcoin trades for 5 seconds and tell me if there's more buying or selling pressure." (实时监控比特币交易5秒钟,并判断买卖压力)

    LLM 将根据 Prompt 内容,自动调用相应的工具,并将结果返回给您。

信息

分类

网页与API