🚀 Binance MCP Server

基于ccxt库为Binance交易所开发的MCP（Model Context Protocol）服务，让AI agents（如Claude Code）能够安全、高效地进行数字货币交易操作。提供完整的现货、期货、期权交易功能支持。

✨ 功能特性

🎯 专为非技术用户设计

• 零编程经验要求 - 通过简单的CLI命令即可完成所有配置

• AI助手友好 - 完美兼容Claude Code等AI编程助手

• 一键安装部署 - 单条命令完成安装和配置

🔧 技术特性

• 内置配置优化 - 自动优化交易参数和连接配置

• 高效执行 - 基于ccxt库的稳定交易执行

• 零额外成本 - 不增加任何交易费用

🛡️ 企业级安全

• 本地加密存储 - API密钥使用Fernet对称加密

• 多账户隔离 - 支持现货、期货、沙盒环境分离管理

• 无网络传输 - 密钥仅在本地存储，绝不上传

• 权限最小化 - 仅申请必要的API权限

📊 完整交易支持

• 现货交易 - 市价单、限价单、止损单等

• 期货合约 - USD-M、币本位期货，支持杠杆调整

• 期权交易 - Call/Put期权买卖

• 账户管理 - 余额查询、持仓管理、交易历史

🔧 完整的MCP工具集（30个工具）

🏪 现货交易

• create_spot_order - 创建现货订单

📋 订单管理

• cancel_order - 取消订单

• get_open_orders - 查看待成交订单

• get_order_status - 查询单个订单状态

• get_my_trades - 获取成交记录

• cancel_all_orders - 批量取消订单

🛡️ 风险控制

• create_stop_loss_order - 创建止损订单

• create_take_profit_order - 创建止盈订单

• create_stop_limit_order - 创建止损限价订单

• create_trailing_stop_order - 创建追踪止损订单

• create_oco_order - 创建OCO订单

📊 市场数据

• get_ticker - 获取价格行情

• get_order_book - 获取订单簿深度

• get_klines - 获取K线数据

• get_funding_rate - 获取资金费率

🎯 期权交易

• create_option_order - 创建期权订单

• get_option_chain - 获取期权链

• get_option_positions - 获取期权持仓

• get_option_info - 获取期权合约信息

📈 合约交易

• create_contract_order - 创建合约订单

• close_position - 一键平仓

• get_futures_positions - 获取期货持仓详情

💰 账户管理

• get_balance - 查询余额

• get_positions - 查看持仓

• set_leverage - 设置杠杆倍数

• set_margin_mode - 设置保证金模式

• transfer_funds - 账户间转账

ℹ️ 系统工具

• get_server_info - 服务器状态信息

Related MCP server: Binance MCP Server

🚀 快速开始

1. 安装

2. 配置账户

3. 启动服务

4. 在Claude Code中使用

启动服务后，在Claude Code中直接说：

"帮我查看BTC的当前价格"

"用我的现货账户买入0.001个BTC"

"查看我的账户余额"

Claude Code会自动调用相应的MCP工具完成操作！

🤖 AI框架集成

LangGraph Agent集成

将Binance MCP工具集成到您现有的LangGraph Agent中：

其他AI框架

本项目遵循标准MCP协议，可与任何支持MCP的AI框架集成：

• Anthropic Claude - 原生支持

• OpenAI Assistants - 通过MCP适配器

• LangChain/LangGraph - 通过mcp-langchain

• CrewAI - 通过MCP工具适配

• AutoGen - 通过MCP协议集成

快速测试集成

🎉 功能完整度

通过集成Binance MCP，您的AI Agent可以：

📊 完整交易生态

• 现货交易 - 买卖各种数字货币

• 期货合约 - 杠杆交易、一键平仓

• 期权策略 - Call/Put期权买卖

• 风险管控 - 止损止盈、追踪止损、OCO订单

📈 深度市场分析

• 实时价格 - 获取各种交易对价格

• K线数据 - 多种时间周期历史数据

• 订单簿深度 - 买卖盘深度分析

• 资金费率 - 期货合约资金费率

💰 专业账户管理

• 多账户支持 - 现货、期货、期权账户

• 杠杆设置 - 动态调整杠杆倍数

• 保证金模式 - 全仓/逐仓切换

• 资金划转 - 账户间资金管理

🛡️ 企业级安全

• 本地加密 - API密钥本地加密存储

• 权限最小化 - 仅授予必要权限

• 合规返佣机制 - 支持合作伙伴返佣计划

• 多环境支持 - 生产/沙盒环境隔离

🚀 30个专业交易工具，构建完整的数字货币交易AI生态系统！

📋 详细使用指南

配置API密钥

1. 获取API密钥：

   • 登录Binance

   • 前往 API管理 页面

   • 创建新的API密钥

   • 权限设置：勾选"现货与杠杆交易"和"期货交易"

   • 重要：启用IP白名单限制

2. 配置密钥：

   binance-mcp config

   按提示输入：

   • 账户ID（自定义名称）

   • API Key

   • Secret Key

   • 是否为沙盒环境

   • 账户描述

服务管理命令

高级配置

多账户管理：

自定义服务器设置：

🔧 故障排除

常见问题

**Q: 出现"Functions with kwargs are not supported as tools"错误？

A: 这是旧版本的问题，请更新：

Q: API密钥认证失败？

A: 检查以下几点：

1. API密钥是否正确复制（注意空格）

2. 是否启用了必要的权限（现货/期货交易）

3. 是否设置了IP白名单限制

4. 沙盒/生产环境是否匹配

Q: 服务无法启动？

A: 检查端口是否被占用：

Q: Claude Code找不到MCP工具？

A: 确保：

1. 服务正在运行：binance-mcp status

2. 重启Claude Code

3. 检查MCP配置文件

日志查看

诊断和调试工具

项目提供了专业的诊断工具帮助快速定位问题：

权限诊断功能：

• ✅ 现货、期货、期权权限检查

• ✅ 网络连接和IP白名单检查

• ✅ 详细错误码解释和修复建议

• ✅ 权限配置分步指导

统一账户调试功能：

• ✅ 自动检测账户类型（普通/统一）

• ✅ 提供配置修改建议

• ✅ SHIB交易符号说明

• ✅ 实时余额和价格查询

🔄 更新指南

检查更新

更新到最新版本

方法1：重新安装（推荐）

方法2：强制重装

方法3：指定版本

更新说明

• ✅ 配置保持不变 - 更新不会影响已配置的账户

• ✅ 向后兼容 - 新版本兼容旧配置

• ✅ 热更新支持 - 无需重新配置API密钥

🏗️ 开发者指南

本地开发

测试覆盖

代码结构

🤝 贡献指南

提交Issue

遇到问题请提交Issue，包含：

• 操作系统版本

• Python版本

• 完整错误信息

• 复现步骤

贡献代码

1. Fork项目

2. 创建功能分支：git checkout -b feature/amazing-feature

3. 提交更改：git commit -m 'Add some amazing feature'

4. 推送分支：git push origin feature/amazing-feature

5. 提交Pull Request

⚠️ 风险提醒

交易风险

• 数字货币交易具有高风险，可能导致资金损失

• 建议先在沙盒环境充分测试

• 设置合理的止损和仓位管理

• 不要投入超过承受能力的资金

技术风险

• 确保API密钥安全，不要分享给他人

• 定期备份配置文件

• 在受信任的网络环境中使用

• 保持软件更新到最新版本

合规提醒

• 遵守当地法律法规

• 了解税务申报义务

• 符合反洗钱要求

📞 支持与反馈

• GitHub Issues: 提交问题

• 讨论区: GitHub Discussions

• 文档: 项目Wiki

📄 许可证

本项目采用 MIT License 开源协议。

🙏 致谢

• ccxt团队 - 提供优秀的交易所API统一库

• FastMCP团队 - 提供高性能的MCP服务器框架

• 开源社区 - 感谢每一位贡献代码和反馈的开发者

⭐ 如果这个项目对您有帮助，请给我们一个Star！⭐

🏠 首页 • 📖 文档 • 🐛 问题反馈 • 💡 功能建议