项目简介
本项目是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在为大型语言模型(LLM)提供访问币安交易所比特币市场数据的能力。通过标准化的 MCP 接口,LLM 可以便捷地获取比特币的实时价格、订单簿、交易记录以及历史价格数据,从而增强 LLM 在金融分析和市场监控等方面的应用能力。
主要功能点
- 实时行情数据: 获取比特币当前价格、24小时涨跌幅、成交量等实时行情信息。
- 订单簿数据: 查询币安交易所比特币订单簿的最佳买入价和卖出价。
- 近期交易记录: 获取最近的比特币交易记录,了解市场交易动态。
- 历史价格数据: 获取可自定义时间间隔的比特币历史价格数据,支持多种K线周期。
- 实时价格流: 短期订阅比特币实时价格更新,监测市场价格波动。
安装步骤
-
克隆仓库
git clone https://github.com/MilesCool/binance-mcp.git cd binance-mcp -
安装依赖
pnpm install -
构建项目
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 建立连接。
基本使用方法
-
启动 MCP 服务器
在仓库根目录下,运行以下命令启动 Binance Bitcoin MCP Server:
pnpm start -
连接 MCP 客户端
配置您的 MCP 客户端,使其连接到正在运行的 Binance Bitcoin MCP Server。客户端应使用 Stdio 传输协议与服务器通信。
-
通过 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