CVEX MCP Server

CVEX MCP 服务

用于与 CVEX Trading API 交互的模型上下文协议（MCP）服务。此服务允许 Claude 与 CVEX 交易平台交互、查看市场数据和账户信息，以及执行交易。

功能

• 🔍 市场数据访问：查看可用合约和实时市场数据
• 💰 账户管理：查看账户余额和持仓信息
• 📊 交易功能：直接通过 Claude 下单和管理订单
• 🔐 安全交易：仅在需要对请求进行签名时访问私钥

安装

npm install -g @modelcontextprotocol/server-cvex

与 Claude Desktop 搭配使用

如需在 Claude Desktop 中使用此服务，请运行：

claude --mcp "npx @modelcontextprotocol/server-cvex --api-key YOUR_API_KEY --private-key-path /path/to/private_key.pem"

将 YOUR_API_KEY 替换为实际的 CVEX API 密钥，并将 /path/to/private_key.pem 替换为私钥文件的路径。

命令行选项

选项	说明
--api-key <key>	CVEX API 密钥
--private-key-path <path>	私钥文件的路径（交易操作必需）
--api-url <url>	CVEX API URL（默认值：https://api.cvex.trade）
--help	显示帮助信息
--version	显示版本号

可用工具

MCP 服务向 Claude 提供以下工具：

1. getMarketData：获取指定合约的市场数据
2. getContractDetails：获取指定合约的详细信息
3. getAccountInformation：获取账户信息，包括余额
4. estimateOrder：估算订单，但不执行
5. placeOrder：在交易所下新订单

Claude 查询示例

连接后，你可以向 Claude 提出以下请求：

What contracts are available on CVEX?
Show me the current market data for BTCUSD
What's my account balance?
Estimate how much it would cost to buy 0.1 BTC at market price
Place a limit order to buy 0.01 ETH at $4000

安全注意事项

• 仅在需要对交易请求进行签名时读取私钥
• 私钥在内存中的存留时间不会超过必要时长
• 所有 API 请求均通过安全的 HTTPS 连接发送
• 确认交易前，务必核对订单详情
• 使用 CVEX MCP 服务时，切勿与他人共享终端会话

开发

1. 克隆仓库
2. 使用 npm install 安装依赖
3. 使用 npm run build 构建项目
4. 使用 node dist/cli.js [options] 运行服务

另请参阅

• USAGE.md，了解更详细的使用示例
• CVEX API 文档

许可证

MIT