Revolutx MCP

RevolutX MCP 服务器

模型上下文协议（MCP）服务器 Revolut X加密交换REST API该服务器提供了一套全面的工具，允许AI代理与Revolut X交易所进行交互——下单、获取市场数据、管理头寸等。

所有私有API请求都使用进行身份验证 Ed25519请求签名 (X-Revx-Signature)，遵循官方的Revolut X身份验证协议。

______________________________________________________________________

特性

订单

交易

市场数据

公开市场数据

配置

平衡

______________________________________________________________________

提示

______________________________________________________________________

先决条件

• Node.js >= 18
• npm
• A. Revolut X API密钥 （从Revolut X网络应用程序获取）
• 一 Ed25519私钥 （用于请求签名）

安装

1. 克隆存储库：

   git clone https://github.com/Bilel-Eljaamii/revolutx-mcp.git
   cd revolutx-mcp

1. 安装依赖项：

   npm install

配置

1. 复制示例环境文件：

   cp .env.example .env

1. 编辑 .env 并配置这两个必需的变量：

   # Your Revolut X API Key (64-character alphanumeric string)
   REVOLUTX_API_KEY=your_api_key_here

   # Your Ed25519 Private Key for request signing
   REVOLUTX_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----
   your_base64_private_key_here
   -----END PRIVATE KEY-----"

注： 两者 REVOLUTX_API_KEY 和 REVOLUTX_PRIVATE_KEY 所有私有端点都需要。公共端点(get_last_trades, get_order_book)无需身份验证即可工作。

生成Ed25519密钥对

openssl genpkey -algorithm Ed25519 -out private.pem
openssl pkey -in private.pem -pubout -out public.pem

上传 公钥 转到您的Revolut X帐户设置，并设置以下内容 private.pem 作为 REVOLUTX_PRIVATE_KEY 在你的 .env 文件。

______________________________________________________________________

脚本

______________________________________________________________________

用法

构建与运行

npm run build
npm start

或者，只需一步：

npm run dev

MCP客户端配置

要将此服务器与MCP客户端（例如，Claude Desktop、Cursor）一起使用，请在MCP客户端配置中添加以下内容：

{
  "mcpServers": {
    "revolutx": {
      "command": "node",
      "args": ["/path/to/revolutx-mcp/dist/index.js"],
      "env": {
        "REVOLUTX_API_KEY": "your_api_key_here",
        "REVOLUTX_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\nyour_base64_key\n-----END PRIVATE KEY-----"
      }
    }
  }
}

*替换 /path/to/revolutx-mcp 带有项目目录的绝对路径。*

______________________________________________________________________

建筑

src/
├── index.ts                          # MCP server entry point
├── utils.ts                          # Auth (Ed25519 signing), error handling
├── tools/
│   ├── balance/
│   │   └── get_balances.ts
│   ├── configuration/
│   │   ├── get_currencies.ts
│   │   └── get_pairs.ts
│   ├── orders/
│   │   ├── place_order.ts
│   │   ├── cancel_order_by_id.ts
│   │   ├── cancel_all_orders.ts
│   │   ├── get_order_by_id.ts
│   │   ├── get_active_orders.ts
│   │   ├── get_historical_orders.ts
│   │   └── get_order_fills.ts
│   ├── trades/
│   │   ├── get_all_trades.ts
│   │   └── get_private_trades.ts
│   ├── market_data/
│   │   ├── get_order_book_snapshot.ts
│   │   ├── get_candles.ts
│   │   └── get_tickers.ts
│   └── public_market_data/
│       ├── get_last_trades.ts
│       └── get_order_book.ts
├── resources/
│   └── index.ts
└── prompts/
    └── index.ts

身份验证流程

所有API私有请求都遵循Revolut X Ed25519签名协议：

1. 生成时间戳(Date.now())
2. 连接： timestamp + HTTP_METHOD + path + query + body
3. 签署 crypto.sign(null, message, privateKey) （纯Ed25519）
4. 附加标题： X-Revx-API-Key, X-Revx-Timestamp, X-Revx-Signature

______________________________________________________________________

API 参考

此服务器实现了完整 Revolut X加密交换REST API:

• 订单
• 交易
• 市场数据
• 公开市场数据
• 配置
• 平衡

______________________________________________________________________

许可证

国际学生中心