mcp-binance-futures 是一个 MCP（模型上下文协议）服务器，旨在为大型语言模型提供与 Binance USDT-M 期货交互的能力。项目使用 FastMCP 和 httpx 构建，将 Binance API 的调用封装为可供 LLM 调用的工具。
用途
该服务器用于让 LLM 监控、开仓和管理期货交易，涵盖市场数据、账户状态、订单管理以及仓位和保证金控制。
主要能力
服务器暴露的工具分为以下类别：
- 市场数据（公开接口，无需认证）
- 账户信息（需要签名认证）
- 订单管理（需要签名认证）
- 仓位管理（需要签名认证）
这些工具的组合旨在提供 LLM 所需的全面功能，以完成期货交易的监控、下单和管理。
使用方式
首先需要创建启用了 Futures 交易的 Binance API 密钥，并设置环境变量。推荐使用 uv 或 pip 进行安装。出于安全考虑，建议使用 IP 白名单，并切勿将密钥提交到版本控制系统。
对于 MCP 客户端，可以将服务器配置添加到 ~/Library/Application Support/Claude/claude_desktop_config.json 文件中。
项目提供了测试，使用 respx 模拟所有 HTTP 调用，因此无需真实的 API 密钥或网络。
客户端和服务器在代码中被刻意分离：client.py 处理所有 Binance API 机制（HMAC 签名、错误解析、HTTP 动词），而 server.py 仅包含工具逻辑和 MCP 连接。这种设计使得两者可以独立测试。
适用场景
适用于需要通过 LLM 自动化或辅助执行 Binance USDT-M 期货交易的场景，例如开立带止损止盈的多头仓位、修改限价单、紧急平仓等。
限制
具体限制信息暂未提供。使用前需确保具备 Binance 期货交易权限，并遵守相关安全实践。
