关于 Eterna MCP
Eterna MCP 是面向交易 Agent 的托管执行层,通过 TypeScript SDK 提供永续合约和 USDT 现货交易及账户操作。它将 SDK 搜索与沙箱代码执行结合,允许一次调用运行多步操作。
主要功能
- 01搜索 eterna SDK 文档与示例
- 02在 Deno 沙箱中执行 TypeScript
- 03获取行情、订单簿和技术指标
- 04管理订单、仓位与账户
- 05支持永续合约和 USDT 现货
适用场景
- 01查询市场数据和技术指标
- 02提交或管理交易订单与仓位
- 03查看余额、持仓及资金记录
MCP 相关
Eterna MCP 通过 Streamable HTTP 暴露代码执行、SDK 搜索和示例搜索工具,并提供提示词与文档资源。客户端使用 OAuth 或 Bearer API key 认证。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.eterna.exchange/mcpclaude mcp add --transport http eternahybridexchange-eterna https://mcp.eterna.exchange/mcp{"mcpServers":{"eternahybridexchange-eterna":{"type":"http","url":"https://mcp.eterna.exchange/mcp"}}}在 Cursor 中打开{"servers":{"eternahybridexchange-eterna":{"type":"http","url":"https://mcp.eterna.exchange/mcp"}}}在 VS Code 中打开{"mcpServers":{"eternahybridexchange-eterna":{"type":"http","url":"https://mcp.eterna.exchange/mcp"}}}{"mcpServers":{"eternahybridexchange-eterna":{"serverUrl":"https://mcp.eterna.exchange/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://mcp.eterna.exchange/mcp需要授权工具
详细介绍
Eterna MCP Gateway
为你的 AI Agent 提供真实交易能力的最快方式。
无需 KYC。沙箱化的 TypeScript SDK。隔离的子账户。期货挂单费率为 0.014%。
30 秒完成安装
将其添加到你的 MCP 客户端,并按提示完成 OAuth:
{
"mcpServers": {
"eterna": {
"type": "streamable-http",
"url": "https://mcp.eterna.exchange/mcp"
}
}
}
你的 Agent 会在首次登录时自动配置。没有 register_agent 工具。
查看 QUICKSTART.md,了解 Claude、Cursor 和 Openclaw 的操作指南。
产品网站:ai.eterna.exchange
工作原理
Eterna 不是为每个交易所 API 端点都提供一个 MCP 工具的服务。
- Agent 调用
search_sdk,查找合适的eterna.*方法。 - Agent 调用
execute_code,通过一段 TypeScript 代码使用完整 SDK,一次往返即可完成。 - 代码在沙箱化的 Deno 运行时中执行,并以 JSON 形式返回结果。
与将每个 Bybit 调用都封装为独立 MCP 工具相比,这种模式可减少约 90% 的 Token 使用量。
MCP 工具
| 工具 | 描述 |
|---|---|
execute_code | 在 Deno 沙箱中运行 TypeScript,并使用 eterna.* 交易 SDK |
search_sdk | 搜索 SDK 文档(list / summary / full / params / keywords) |
search_examples | 对精选交易示例进行语义搜索 |
提示词
| 提示词 | 描述 |
|---|---|
getting_started | 如何使用 execute_code、充值流程和沙箱规则 |
sdk_reference | 完整的 eterna.* 方法签名和响应结构 |
error_handling | 错误类别及恢复方法 |
technical_analysis | RSI、MACD、EMA、SMA、布林带、VWAP |
strategy_momentum_scalping | 可选策略模板 |
strategy_mean_reversion | 可选策略模板 |
strategy_funding_rate_arbitrage | 可选策略模板 |
资源
| URI | 描述 |
|---|---|
eterna://docs/sdk | 完整 SDK 参考 |
eterna://docs/errors | 错误参考 |
eterna://docs/examples | 示例代码片段 |
完整参数文档:docs/tools-reference.md
SDK 方法(通过 execute_code 调用)
沙箱中的 eterna 对象提供 30 个方法(默认使用线性永续合约;USDT 现货可通过 market: "spot" 和 sellSpotBalance 使用):
| 类别 | 方法 |
|---|---|
| 市场数据 | getTickers、getOrderbook、getInstruments(可选 market:线性合约或现货) |
| 技术分析 | getRsi、getMacd、getEma、getSma、getBollingerBands、getVwap |
| 交易 | placeOrder、sellSpotBalance、closePosition、cancelOrder、cancelAllOrders、setLeverage、setTradingStop |
| 账户 | getBalance、getAccountInfo、getAllCoinsBalance、getPositions、getOrders |
| 资金 | getDepositAddress、getDepositRecords、getAllowedDepositCoins、transferToTrading、swapToUsdt、getCoinInfo、getWithdrawableAmount、submitWithdrawal、getWithdrawalStatus |
示例:
const balance = await eterna.getBalance();
const ticker = await eterna.getTickers("BTCUSDT");
return { equity: balance.totalEquity, last: ticker[0]?.lastPrice };
为什么选择 Eterna?
| Eterna(托管) | 可自托管的 MCP 服务 | 直接 API 封装 | |
|---|---|---|---|
| 设置时间 | 约 30 秒 | 15–30 分钟 | 数小时 |
| 认证 | OAuth(或旧版 API 密钥) | 由你创建并轮换密钥 | 由你创建并轮换密钥 |
| Agent 隔离 | 每个 Agent 配备专用子账户 | 共享账户 | 共享账户 |
| 执行模式 | 沙箱化的 TypeScript SDK | 通常每个端点对应一个工具 | 自定义代码 |
| 传输方式 | Streamable HTTP(远程) | 通常为 stdio(仅本地) | HTTP |
| 维护 | 无需维护——我们负责更新 | 由你管理 | 由你管理 |
| 期货费率 | 挂单 0.014% / 吃单 0.035% | 零售费率,除非协商 VIP 费率 | 零售费率,除非协商 VIP 费率 |
你无需构建的内容
- 子账户开通
- 速率限制和请求校验
- 充值地址管理和资金路由
- 交易所 API 变更的错误处理
- Deno 沙箱和类型化交易 SDK
兼容你的技术栈
Claude (claude.ai)
添加自定义连接器,URL 为 https://mcp.eterna.exchange/mcp,完成 OAuth 并点击 Approve。
Claude Code / Cursor
使用上述 JSON 配置(Claude Code:.mcp.json,Cursor:.cursor/mcp.json)。按提示完成 OAuth。
Openclaw
openclaw plugins install @eterna-hybrid-exchange/openclaw-plugin
npm install -g @eterna-hybrid-exchange/cli
eterna login
任意 Streamable HTTP MCP 客户端
将客户端指向 https://mcp.eterna.exchange/mcp,并通过 OAuth(mcp:full)或旧版 Bearer API 密钥进行身份验证。面向 LangChain / CrewAI / AutoGen / ChatGPT 的完善指南正在陆续推出。
身份验证
首选: 通过 https://ai-auth.eterna.exchange 使用 OAuth,范围为 mcp:full。
旧版: 长期有效的 Agent API 密钥,格式为 Authorization: Bearer …(静态存储时使用 Argon2 哈希)。
市场
- USDT 保证金永续合约(200 多个交易对,默认
market: "linear") - 通过
placeOrder({ …, market: "spot" })、sellSpotBalance(symbol)以及支持现货的市场数据/订单方法交易 USDT 现货
路线图
参见 ROADMAP.md。
已交付: 代码执行沙箱、OAuth Agent 开通、30 种 SDK 方法(永续合约 + USDT 现货)、技术分析、资金费率/提现流程。
下一步: 扩展 SDK 覆盖范围、Cron 策略运行时、回测。
技能
用于交易知识的 Claude Code 技能:
- skills/claude-code/trading/SKILL.md — 风险管理、仓位规模、充值流程、订单生命周期
- skills/claude-code/scalping/SKILL.md — 动量剥头皮策略
也可获取最新套件:https://ai.eterna.exchange/claude-skills
文档
- QUICKSTART.md — 连接并交易
- 工具参考 — MCP 工具 + SDK 概览
- 身份验证 — OAuth 和 API 密钥
- 架构 — 隔离和传输
- CHANGELOG.md — 版本历史
- ROADMAP.md — 后续计划
机器可读的产品信息:https://ai.eterna.exchange/llms.txt
联系方式
咨询、合作或支持:[email protected]
许可证
MIT — 版权所有 2025-2026 Eterna Exchange
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。