币安-mcp服务器

Name: 币安-mcp服务器
Author: AnalyticAce

作者：AnalyticAce34 星标更新：2025-08-07

安装使用来源：spider==github.com

项目介绍

Binance MCP Server 🚀

一个强大的模型上下文协议（MCP）服务器，使AI代理能够无缝地与币安加密货币交易所进行交互。该服务器通过标准化的MCP接口提供全面的交易工具、市场数据访问和账户管理能力。

🎯 主要特点

安全认证：基于API密钥的身份验证与币安
实时市场数据：实时价格推送、订单簿数据和市场统计
交易操作：在现货和期货市场上下单、修改和取消订单
投资组合管理：账户余额跟踪、仓位监控和损益分析
智能通知：实时价格变动、订单成交和市场事件提醒
风险管理：内置的安全保障和交易操作验证

🚀 快速开始

预备条件

系统上安装了Python 3.10+
具有API访问权限的币安账户
从您的币安账户获取的API凭证（API密钥及秘密）

1️⃣ 安装

从PyPI安装官方包：

# 推荐：使用pip安装
pip install binance-mcp-server

# 替代方案：使用uv进行更快的包管理
uv add binance-mcp-server

💡 为什么使用PyPI包？

✅ 始终与最新发布保持同步

✅ 自动依赖管理

✅ 简单的安装和更新

✅ 不需要克隆仓库或管理源代码

2️⃣ 配置

设置您的币安API凭证作为环境变量：

# 必需：您的币安API凭证
export BINANCE_API_KEY="your_api_key_here"
export BINANCE_API_SECRET="your_api_secret_here"

# 推荐：开发和测试时使用testnet
export BINANCE_TESTNET="true"

3️⃣ 启动服务器

# 启动MCP服务器（从PyPI安装后）
binance-mcp-server --api-key $BINANCE_API_KEY --api-secret $BINANCE_API_SECRET --binance-testnet

4️⃣ 连接您的AI代理

配置您的AI代理（Claude、GPT-4或自定义机器人）以连接到MCP服务器：

{
  "mcpServers": {
    "binance": {
      "command": "binance-mcp-server",
      "args": [
        "--api-key", "your_api_key",
        "--api-secret", "your_secret",
        "--binance-testnet" 
      ]
    }
  }
}

📚 可用工具

我们的MCP服务器提供了15种全面的交易工具，使AI代理能够执行加密货币交易操作。每个工具都遵循模型上下文协议标准，实现无缝集成。

🏦 账户与投资组合管理

工具	目的
`get_balance`	获取所有资产的账户余额
`get_account_snapshot`	账户状态快照（时间点）
`get_fee_info`	交易费用率（买卖双方佣金）
`get_available_assets`	列出所有可交易的加密货币和交易所信息

📊 市场数据与分析

工具	目的
`get_ticker_price`	获取交易符号的当前价格
`get_ticker`	24小时价格变化统计数据
`get_order_book`	获取交易符号的当前订单簿（买单/卖单）

💱 交易操作

工具	目的
`create_order`	创建买入/卖出订单（市价、限价等）
`get_orders`	获取特定符号的历史订单

📈 绩效与分析

工具	目的
`get_pnl`	计算期货交易的利润和损失
`get_position_info`	获取开放的期货仓位详情

🏪 钱包与转账

工具	目的
`get_deposit_address`	获取特定币种的存款地址
`get_deposit_history`	获取特定币种的存款历史
`get_withdraw_history`	获取特定币种的提款历史

🛡️ 风险管理

工具	目的
`get_liquidation_history`	获取过去的清算事件

🔧 配置

环境变量

变量	描述	是否必需	默认值
`BINANCE_API_KEY`	您的币安API密钥	✅	-
`BINANCE_API_SECRET`	您的币安API秘密	✅	-
`BINANCE_TESTNET`	使用testnet环境	❌	`false`

🛠️ 开发

📝 注意：此部分适用于希望修改源代码的贡献者和开发者。常规用户应按照上述说明从PyPI安装。

开发环境设置

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

# 2. 创建并激活虚拟环境
python -m venv venv
source venv/bin/activate  # 在Windows上：venv\Scripts\activate

# 3. 安装开发依赖项（选择一种）
# 方案A：如果可用，使用uv
uv install --dev

# 方案B：使用pip
pip install -e .
pip install pytest  # 用于测试

# 4. 设置预提交钩子（可选）
pip install pre-commit
pre-commit install --hook-type commit-msg

# 5. 运行测试以验证设置
pytest

# 6. 启动开发服务器
python -m binance_mcp_server.cli

测试策略

# 运行所有测试
pytest

# 运行带有覆盖率报告的测试
pytest --cov=binance_mcp_server --cov-report=html

# 运行特定测试类别
pytest tests/test_tools/test_account.py -v

🤝 贡献

我们欢迎来自加密货币和AI开发社区的贡献！以下是您可以如何帮助：

🎯 当前优先事项

查看我们的GitHub问题，了解最新的开发优先事项：

增强交易工具 - 订单取消、修改和高级订单类型
投资组合管理 - 高级投资组合分析和资产配置工具
风险管理扩展 - 边际监控、杠杆管理和清算警报
市场数据增强 - 历史数据、技术指标和市场分析
警报系统 - 价格通知和仓位监控
文档与示例 - 全面指南和用例示例

📋 贡献指南

分叉与分支：从main创建一个特性分支
编码：遵循我们的编码标准
预提交钩子：安装并配置预提交钩子以验证提交消息
测试：为新功能添加测试（目标覆盖率>80%）
文档：更新用户界面更改的文档
审查：提交拉取请求以供审查

🔧 贡献者的开发设置

💡 对于常规使用：大多数用户应通过pip install binance-mcp-server安装，而不是克隆此仓库。

# 克隆您的分叉
git clone https://github.com/your-username/binance-mcp-server.git
cd binance-mcp-server

# 安装依赖项并设置环境（选择一种）
# 方案A：如果可用，使用uv
uv install --dev

# 方案B：使用pip
pip install -e .
pip install pytest pre-commit

# 安装预提交钩子（强制执行提交消息约定）
pre-commit install --hook-type commit-msg

# 使用常规格式进行更改并提交
git commit -m "feat(tools): 添加新的市场数据工具"

🏷️ 问题标签

good first issue - 新手完美入门
enhancement - 新功能和改进
bug - 某些内容工作不正常
documentation - 需要更新文档
help wanted - 请求社区协助

📋 开发标准

MCP协议合规性：完全遵守模型上下文协议标准
预提交钩子：所有贡献者必须安装以确保提交消息一致性
类型提示：需要完整的类型注解
测试：pytest，目标覆盖率>80%
提交：强制执行常规提交格式（feat:，fix:等）由预提交钩子
文档：Google风格的文档字符串
安全性：全面的输入验证和安全错误处理

🔒 安全与最佳实践

🛡️ MCP协议合规性

此服务器实现了全面的安全措施，遵循模型上下文协议的最佳实践：

增强的输入验证：所有输入都被验证和清理
安全错误处理：错误消息被清理以防止信息泄露
速率限制：内置保护防止API滥用
凭据保护：不记录或暴露敏感数据
审计日志：全面的安全事件跟踪

🔐 API安全

凭据管理：永远不要将API密钥提交到版本控制中
先使用testnet：在真实交易之前始终使用币安testnet
速率限制：内置尊重币安API速率限制
输入验证：全面验证所有交易参数
审计日志：所有操作的完整审计轨迹

🔐 环境安全

# 使用环境变量存储敏感数据
export BINANCE_API_KEY="your_key_here"
export BINANCE_API_SECRET="your_secret_here"

# 开发时启用testnet
export BINANCE_TESTNET="true"

# 可选：配置安全功能
export MCP_RATE_LIMIT_ENABLED="true"
export MCP_MAX_REQUESTS_PER_MINUTE="60"

📖 阅读完整安全文档 - 全面的安全指南和最佳实践。

💡 使用示例

📊 市场数据查询

# 获取实时比特币价格
{
    "name": "get_ticker_price",
    "arguments": {
        "symbol": "BTCUSDT"
    }
}

# 获取以太坊的24小时价格统计数据
{
    "name": "get_ticker", 
    "arguments": {
        24小时价格统计数据
        "symbol": "ETHUSDT"
    }
}

# 检查以太坊的当前订单簿
{
    "name": "get_order_book", 
    "arguments": {
        "symbol": "ETHUSDT",
        "limit": 10
    }
}

💰 账户管理

# 检查账户余额
{
    "name": "get_balance",
    "arguments": {}
}

# 获取账户快照
{
    "name": "get_account_snapshot",
    "arguments": {
        "account_type": "SPOT"
    }
}

🛒 交易操作

# 创建以太坊的限价买单
{
    "name": "create_order",
    "arguments": {
        "symbol": "ETHUSDT",
        "side": "BUY", 
        "order_type": "LIMIT",
        "quantity": 0.1,
        "price": 2000.00
    }
}

# 获取特定符号的历史订单
{
    "name": "get_orders",
    "arguments": {
        "symbol": "ETHUSDT"
    }
}

📈 绩效分析

# 计算利润和损失
{
    "name": "get_pnl",
    "arguments": {}
}

# 获取仓位信息
{
    "name": "get_position_info",
    "arguments": {}
}

🎯 路线图

🚀 第一阶段：核心基础 ✅

MCP服务器框架 - FastMCP集成和基本结构
MCP协议合规性 - 增强的安全性和最佳实践实施
文档与规划 - 全面的工具规范
身份验证系统 - 安全的币安API集成
基本工具实现 - 必要的交易和账户工具（15个工具）
安全功能 - 输入验证、错误清理、速率限制

📊 第二阶段：交易操作 🚧

订单管理 - 基本订单创建和历史
市场数据集成 - 实时价格推送和订单簿
投资组合分析 - 基本的损益跟踪和仓位信息
高级订单类型 - 止损、获利、OCO订单
订单取消 - 取消和修改现有订单
增强的风险管理 - 高级边际监控

🔥 第三阶段：高级功能 📋

高级分析 - 技术指标和市场洞察
警报系统 - 价格通知和仓位监控
策略工具 - DCA、网格交易和自动化助手
多账户支持 - 跨保证金、隔离保证金账户

📈 成功指标

工具覆盖：15/15核心工具已实现 ✅
测试覆盖率：>90%代码覆盖率目标（目前38个测试通过）
安全合规性：MCP最佳实践已实现 ✅
性能：<100毫秒平均API响应时间
社区：GitHub参与度和贡献增长
生产使用：PyPI上的稳定包发布

📄 许可证

本项目根据MIT许可证发布 - 查看LICENSE文件以获取详细信息。

🆘 支持与社区

📚 文档与资源

完整文档 - 全面的指南和教程

💬 获取帮助

报告问题 - 错误报告和功能请求
讨论 - 社区问答和想法
电子邮件支持 - 技术问题和合作伙伴咨询

🏷️ 快速帮助标签

创建问题时，请使用这些标签以帮助我们更快响应：

bug - 某些内容工作不正常
enhancement - 功能请求
question - 一般问题
documentation - 文档改进
good first issue - 新手完美入门

⚠️ 法律免责声明

重要通知：此软件仅供教育和开发用途。加密货币交易涉及财务损失的重大风险。

📋 风险确认

测试环境：开发和测试时始终使用币安testnet
财务风险：仅用您能承受损失的资金进行交易
尽职调查：部署到真实交易前进行全面测试
无责任：开发人员不对财务损失承担责任

📄 许可证与归属

本项目根据MIT许可证发布 - 查看LICENSE文件以获取详细信息。

由加密货币开发社区用心打造

⚡ 由模型上下文协议驱动 ⚡

⭐ 关注此项目 | 🍴 分叉并贡献 | 📖 阅读文档

</div>