使用说明

项目简介

Bitpin 交易所 MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端,旨在为大型语言模型 (LLM) 提供访问 Bitpin 加密货币交易所的接口。通过此服务器,LLM 客户端可以安全、便捷地获取市场数据、管理钱包资产以及执行交易操作。

主要功能点

  • 市场数据查询: 提供多种市场数据查询工具,包括:
    • 获取所有支持的加密货币列表
    • 获取所有交易市场列表
    • 获取市场行情数据 (Ticker)
    • 获取市场深度数据 (Orderbook)
    • 获取市场成交记录 (Matches)
  • 账户信息管理: 提供账户钱包信息查询功能。
    • 获取用户钱包列表及余额
  • 订单管理: 支持多种订单类型和管理功能:
    • 创建限价单 (Limit Order)
    • 创建市价单 (Market Order)
    • 创建止损限价单 (Stop-Limit Order)
    • 创建 OCO (One-Cancels-the-Other) 订单
    • 查询订单列表
    • 查询已完成订单
    • 根据订单 ID 查询订单详情
    • 取消订单

安装步骤

  1. 安装 .NET 9 或更高版本: 确保您的运行环境已安装 .NET 9 或更高版本的运行时。您可以从 https://dotnet.microsoft.com/download 下载并安装。
  2. 安装 'BitpinClient' NuGet 包: 此 MCP 服务器依赖 'BitpinClient' NuGet 包来与 Bitpin API 进行交互。在构建项目时,NuGet 包管理器会自动下载安装依赖。

服务器配置

MCP 服务器需要配置 Bitpin API 密钥和密钥,以便访问您的 Bitpin 交易所账户。您需要在 MCP 客户端的服务器配置中指定 MCP 服务器的启动命令和参数。以下是一个示例配置,请根据您的实际项目路径进行调整:

{
  "mcpServers": {
    "BitpinExchange": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "D:\\projects\\bitpin-mcp-server\\src\\MCPServer\\MCPServer.csproj",
        "--no-build"
      ]
    }
  }
}

配置参数说明:

  • server name: 服务器名称,例如 "BitpinExchange",可以自定义。
  • command: 启动服务器的命令,这里使用 'dotnet' 运行 .NET 项目。
  • args: 命令参数,包括:
    • 'run': 运行 .NET 项目的命令。
    • '--project': 指定 'MCPServer.csproj' 项目文件的路径。请务必将 'D:\projects\bitpin-mcp-server\src\MCPServer\MCPServer.csproj' 替换为您实际的项目文件路径。
    • '--no-build': 可选参数,表示在运行前不重新构建项目,加快启动速度。

重要提示:

  • 您需要在 'src/MCPServer/Program.cs' 文件中配置您的 Bitpin API 密钥 (Key) 和密钥 (Secret)。请替换以下代码中的 '****' 为您的实际 API 密钥和密钥。
var settings = new BitpinClientSettings()
{
    Key = "****", // 替换为您的 API 密钥
    Secret = "****", // 替换为您的 API 密钥
};
  • 请妥善保管您的 API 密钥和密钥,避免泄露。

基本使用方法

  1. 启动 MCP 服务器: 配置完成后,启动您的 MCP 客户端。MCP 客户端会根据您在配置中指定的命令和参数来启动 Bitpin 交易所 MCP 服务器。
  2. 通过 LLM 客户端调用工具: 在 LLM 客户端中,您可以使用自然语言指令调用 Bitpin 交易所 MCP 服务器提供的各种工具,例如:
    • "查询 BTC_IRT 市场的最新价格" (对应 'GetTickersListAsync' 工具)
    • "我的 USDT 钱包有多少余额" (对应 'GetWalletsListAsync' 工具)
    • "买入 0.1 个 ETH 的市价单" (对应 'CreateMarketOrderAsync' 工具)

注意: 具体如何通过 LLM 客户端调用这些工具取决于您使用的 MCP 客户端的具体实现和指令格式。请参考您的 MCP 客户端的使用文档。

信息

分类

商业系统