Binance Bitcoin Market Data

🚀 币安比特币 MCP 工具

该项目提供了 Model Context Protocol (MCP) 工具，用于从币安获取比特币价格数据。它能让大型语言模型通过标准化接口，访问实时和历史比特币市场数据。

🚀 快速开始

此工具需与支持MCP的LLM客户端配合使用。具体步骤如下：

# 启动MCP服务器
pnpm start

启动服务器后，使用您的MCP兼容LLM客户端连接，即可交互币安数据。

✨ 主要特性

• 📈 获取当前比特币Ticker数据（价格、24小时变动率、成交量等）
• 📊 获取最优买价和卖价订单簿信息
• 📄 获取近期交易记录
• 📅 拿到可自定义间隔的历史价格数据
• ⚡ 流式获取实时比特币价格更新，时长可控

📦 安装指南

# 克隆仓库
git clone https://github.com/yourusername/binance-mcp.git
cd binance-mcp

# 安装依赖项
pnpm install

# 构建项目
pnpm build

💻 使用示例

基础用法

要与支持MCP的LLM客户端一起使用此工具，可按如下步骤操作：

# 启动MCP服务器
pnpm start

然后使用您的MCP兼容LLM客户端连接以交互币安数据。

可用工具

1. get_bitcoin_ticker - 获取当前比特币Ticker数据

   • 参数:
     • symbol（可选，默认: "BTCUSDT"）- 交易对符号

2. get_bitcoin_order_book - 获取当前最优买价和卖价信息

   • 参数:
     • symbol（可选，默认: "BTCUSDT"）- 交易对符号

3. get_bitcoin_recent_trades - 获取近期交易记录

   • 参数:
     • symbol（可选，默认: "BTCUSDT"）- 交易对符号
     • limit（可选，默认: 10）- 要获取的交易数量

4. get_bitcoin_price_history - 获取历史K线/Candlestick数据

   • 参数:
     • symbol（可选，默认: "BTCUSDT"）- 交易对符号
     • interval（可选，默认: "1h"）- K线时间间隔（1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M）
     • limit（可选，默认: 24）- 要获取的K线数量

5. get_realtime_bitcoin_price - 获取实时价格更新

   • 参数:
     • symbol（可选，默认: "btcusdt"）- 交易对符号（小写）
     • duration（可选，默认: 5，最大值: 30）- 收集实时数据的持续时间（秒）

示例提示供LLM使用

一旦连接到支持MCP的LLM，您就可以使用类似以下的提示：

1. "当前比特币价格和24小时变动率是多少？"
2. "显示当前买价和卖价之间的差价。"
3. "分析过去10笔比特币交易并找出任何模式。"
4. "获取过去24小时的比特币价格历史，并解释其趋势。"
5. "监控实时比特币交易5秒钟，告诉我是否有更多的买入或卖出压力。"

📚 详细文档

开发指南

要对项目进行更改，可按以下步骤操作：

1. 修改src目录下的源代码
2. 运行pnpm build以编译TypeScript代码
3. 使用pnpm start测试您的更改

📄 许可证

免责声明

此工具仅用于教育和 informational目的。不构成财务建议。