Binance MCP 服务器（Claude 集成示例）

关键词

Binance加密货币市场数据JSON-RPCLLM 集成

使用说明（Markdown 格式）

  • 项目简介

    • 该仓库实现了一个基于 MCP（Model Context Protocol）的服务器，用于向 LLM 客户端暴露 Binance 的市场数据、账户信息以及交易相关工具。它通过 MCP 的服务器框架注册了若干工具（市场数据、账户信息、交易操作等），并通过标准的传输方式（如 Stdio）与客户端连接与交互。

  • 主要功能点

    • 支持多类工具集合：
      • Market（市场数据）：获取价格、涨跌、深度、成交、K线、交易所信息等。
      • Account（账户信息）：获取账户余额、交易历史、账户状态、资产分红等。
      • Trading（交易操作）：创建/查询/取消订单等交易相关操作。
    • 使用 JSON-RPC 风格的请求/响应，在服务器端对工具进行注册、参数校验和执行。
    • 集成 Binance 官方 API，支持公有接口与带认证的私有接口（需要 API Key/Secret）。
    • 支持通过 MCP 客户端（如 Claude Desktop）配置启动命令来连接服务。

  • 安装步骤

    • 安装依赖、构建并启动服务的基本流程（按仓库提供的方式）：
      • 安装依赖并构建：npm install、npm run build
      • 启动服务：npm start，或者直接以 npx binance-mcp 启动
    • 注意：启动时需要提供 Binance API Key/Secret（若需要私有操作），并可使用测试网参数进行测试。

  • 服务器配置（面向 MCP 客户端的配置信息说明） 说明：MCP 客户端需要知道要启动的 MCP 服务器的启动命令及参数，下面给出一个示例配置信息。实际环境中请替换为真实的密钥并按需开启测试网。

    { "serverName": "binance-mcp", "command": "npx", "args": ["-y", "binance-mcp"], "env": { "BINANCE_API_KEY": "your_api_key", "BINANCE_API_SECRET": "your_api_secret", "BINANCE_TESTNET": "true" // 如需使用测试网，请设置为 true；正式环境请删除或置为 false } }

    注释：

    • serverName：服务器在 MCP 环境中的名称，建议与实际仓库名称保持一致，便于识别。
    • command + args：启动服务所需的命令及其参数，示例中通过 npx 启动 binance-mcp。
    • env：运行所需的环境变量，包含 Binance 的 API Key/Secret，以及是否使用测试网的开关。实际使用时请填入真实的密钥（请妥善保管，不要在公开场景暴露）。

  • 基本使用方法

    • 通过 MCP 客户端（如 Claude Desktop）连接该服务器后，调用注册的工具即可获取数据或执行交易操作。工具调用时会对参数进行校验，返回结构化结果（成功/错误信息均以统一格式返回）。
    • 常用流程：在对话中让 LLM 通过工具名称和需要的参数来获取信息或执行操作，如获取行情、查询账户余额、下单等。
    • 安全提醒：涉及账户信息与交易操作的工具请确保在受信任的环境中调用，必要时开启只读模式以避免潜在的风险。

  • 运行与调试

    • 使用本地调试时，可以通过命令行启动并通过标准输入/输出与客户端交互，若将来扩展为 WebSocket/SSE 等传输也应兼容 MCP 的工具定义。

服务器信息

访问项目