项目简介
Binance MCP Server 是一个 MCP 服务器的实现,它允许用户通过 Claude Desktop 等 MCP 客户端,安全便捷地访问币安交易所的 API。该服务器封装了币安 API 的常用功能,如账户信息查询、订单簿查看和交易下单等,并以结构化的方式提供给 LLM 应用,从而实现更智能的交易和投资辅助功能。
主要功能点
- 币安 API 集成: 连接币安交易所 API,支持账户信息查询和交易操作。
- 账户管理: 查询币安账户的详细信息,包括余额、交易记录等。
- 市场数据: 获取实时的订单簿数据,辅助交易决策。
- 现货交易: 支持现货市场交易下单,包括市价单和 TWAP 算法订单,以适应不同大小的交易需求。
- 投资组合管理: 查看投资组合构成和估值,可选的历史价值跟踪功能帮助监控投资表现。
- 智能 token 兑换: 支持 token 之间的智能兑换,并具备市场冲击缓解功能,尤其适合大额交易。
- 安全认证: 通过 API 密钥管理和安全连接,保障用户币安账户的安全。
安装步骤
-
克隆仓库
git clone https://github.com/TermiX-official/binance-mcp.git cd binance-mcp -
安装依赖
npm install # 或 yarn install -
配置环境变量
在项目根目录下创建 '.env' 文件,并填入您的币安 API 密钥和密钥:
BINANCE_API_KEY=your_binance_api_key_here BINANCE_API_SECRET=your_binance_api_secret_here注意: 请务必在币安官网创建 API 密钥,并妥善保管。API 密钥的创建步骤请参考仓库 README.md 文档。
-
构建项目
npm run build
服务器配置
要将 Binance MCP Server 添加到 Claude Desktop 等 MCP 客户端,您需要配置 MCP 服务器的启动命令。以下是 Claude Desktop 的配置示例,其他 MCP 客户端的配置方式类似:
编辑 Claude Desktop 的配置文件 'claude_desktop_config.json' (文件路径请参考仓库 README.md 文档),在 'mcpServers' 字段中添加以下配置:
{ "mcpServers": { "binance-mcp": { "command": "node", "args": [ "/path/to/binance-mcp/build/index.js" // 请替换为您的 binance-mcp 项目 build 目录下 index.js 文件的绝对路径 ], "env": { "BINANCE_API_KEY": "您的币安 API Key", // 请替换为您的币安 API Key "BINANCE_API_SECRET": "您的币安 API Secret" // 请替换为您的币安 API Secret }, "disabled": false, "autoApprove": [] } } }
配置参数说明:
- server name: 'binance-mcp' (服务器名称,在 Claude Desktop 中用于标识和选择)
- command: 'node' (启动服务器的命令,这里使用 Node.js)
- args: '["/path/to/binance-mcp/build/index.js"]' (启动命令的参数,指向编译后的 'index.js' 文件路径。请务必替换为您的实际路径)
- env: 环境变量配置,用于传递 API 密钥等敏感信息。
- 'BINANCE_API_KEY': 您的币安 API Key
- 'BINANCE_API_SECRET': 您的币安 API Secret
- disabled: 'false' (设置为 'false' 表示启用该服务器)
- autoApprove: '[]' (自动批准的工具列表,默认为空,表示需要手动批准工具调用)
配置完成后,重启 Claude Desktop 使配置生效。
基本使用方法
-
启动服务器
在项目根目录下,运行以下命令启动 MCP 服务器:
npm start # 或 node build/index.js -
在 MCP 客户端中使用
在 Claude Desktop 等 MCP 客户端中,选择配置中定义的服务器名称 ('binance-mcp'),即可开始使用 Binance MCP Server 提供的功能。
您可以通过客户端提供的界面或指令,调用服务器提供的工具,例如:
- 使用 'binanceAccountInfo' 工具查询币安账户信息。
- 使用 'binanceOrderBook' 工具查看指定交易对的订单簿。
- 使用 'binanceSpotPlaceOrder' 或 'binanceTimeWeightedAveragePriceFutureAlgo' 工具进行现货交易下单。
具体工具的使用方法和参数,请参考仓库 README.md 文档中 "Functions" 章节的说明。
信息
分类
商业系统