项目简介

这是一个实现了 Model Context Protocol (MCP) 的独立服务器，专门用于集成 Ultrade 交易平台的 API。它作为 LLM 客户端和 Ultrade API 之间的桥梁，允许 LLM 通过标准化的工具接口访问和操作 Ultrade 上的数据和功能。

主要功能点

钱包管理: 提供工具用于登录 Ultrade 交易账户、管理交易密钥、获取钱包资产、查看交易记录和交易明细，以及发起提现操作。
市场数据查询: 提供工具用于获取实时的市场价格、订单簿深度、最新交易记录、市场符号、链信息、交易资产列表、费用率等信息。
交易操作: 提供工具用于生成订单签名消息、创建新的买卖订单、以及取消现有的订单。
系统信息: 提供工具用于查询 Ultrade 平台的系统时间、维护状态和版本信息。

安装步骤

检查 Node.js 版本: 确保您的系统安装了 Node.js 23.6.1 或更高版本。
创建目录: 在您的 MCP 客户端（如 Claude 或 Cursor）的数据目录下创建一个名为 'mcp-servers' 的文件夹（如果不存在）。例如，在 macOS 上使用 Claude，路径可能是 '/Users/YOUR_USERNAME/Library/Application Support/Claude/mcp-servers'。

克隆仓库: 进入刚创建的 'mcp-servers' 目录，克隆 Ultrade MCP 仓库：

git clone https://github.com/ultrade-org/ultrade-mcp.git
cd ultrade-mcp

安装依赖: 在仓库目录下安装所需的依赖：
```
npm install
```
构建项目: 编译项目代码：
```
npm run build
```
配置环境变量: 复制 '.env.example' 文件为 '.env'，并根据您的 Ultrade API 密钥和其他配置进行编辑。

完成以上步骤后，服务器的代码已准备好运行，但还需要在您的 MCP 客户端中进行配置才能使用。

服务器配置

MCP 客户端通过配置来发现和启动 MCP 服务器。您需要将 Ultrade MCP 服务器的启动信息添加到您的 MCP 客户端的配置中（通常是一个 JSON 文件）。配置大致如下所示：

{
  "mcpServers": {
    "ultrade-mcp": {
      "command": "node",
      "args": [
        "PATH_TO_YOUR_MCP_SERVERS_FOLDER/ultrade-mcp/dist/index.js"
      ],
      "env": {
        "ULTRADE_API_URL": "您的 Ultrade API 地址 (例如: https://api.ultrade.io)",
        "ITEMS_PER_PAGE": "分页时每页显示的项目数 (例如: 10)",
        // 其他 Ultrade API 或链相关的环境变量，请参考 .env.example
        "ALGORAND_NETWORK": "mainnet 或 testnet",
        "ALGORAND_ALGOD_API": "Algorand Algod API 地址",
        "ALGORAND_ALGOD": "Algorand Algod 地址",
        "ALGORAND_ALGOD_PORT": "Algorand Algod 端口",
        "ALGORAND_TOKEN": "Algorand API Token",
        "ALGORAND_AGENT_WALLET_ACTIVE": "您的 Algorand 代理钱包助记词（请务必妥善保管）"
      }
    }
  }
}

请将 '"PATH_TO_YOUR_MCP_SERVERS_FOLDER"' 替换为您在安装步骤中创建 'mcp-servers' 文件夹的实际路径。根据您的操作系统和客户端（如 Claude, Cursor）不同，路径会有所差异。

基本使用方法

一旦 Ultrade MCP 服务器在您的 MCP 客户端中配置并被客户端成功启动，大型语言模型就可以感知并调用这个服务器提供的工具。

您可以通过与 LLM 交互，向它提出关于 Ultrade 平台的问题或请求执行相关操作，例如：

"帮我查一下比特币/美元（BTC/USD）在 Ultrade 上的最新价格。"
"获取我的 Ultrade 钱包资产列表。"
"查看我在 Ultrade 上的所有挂单。"
"查询 Ultrade 系统的当前时间。"

LLM 会识别出这些请求与 Ultrade MCP 服务器提供的工具相关，并自动调用相应的工具来完成任务，并将结果返回给您。您无需直接与 MCP 服务器或 Ultrade API 进行交互。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息