mcpField
0
0xarchive Mcp

0xarchive Mcp

远程服务
docs.0xarchive.io开发工具132 天前更新

关于 0xarchive Mcp

0xarchive Mcp 是面向交易者、研究者和 Agent 的托管型市场数据 MCP 服务,主要提供只读查询,覆盖 Hyperliquid 和 Lighter。它提供当前及历史数据、账户持仓和覆盖度与时效信息;另行授权后可使用 Webhook 工具。

主要功能

  1. 01查询 Hyperliquid 和 Lighter 市场数据
  2. 02获取成交、K 线、资金费率和订单簿
  3. 03查看持仓与清算数据
  4. 04检查历史覆盖度和数据时效
  5. 05获准后管理 Webhook

适用场景

  1. 01比较不同平台的资金费率数据
  2. 02查看历史 K 线和交易量
  3. 03检查市场订单簿
  4. 04核对数据覆盖度与已记录事件

MCP 相关

通过远程 HTTP 端点向 MCP 客户端提供市场数据和数据质量工具。OAuth 默认授予读取权限;使用 Webhook 工具还需额外的 Webhook 权限范围。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://mcp.0xarchive.io/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

0xArchive MCP:无需密钥和安装,即可向你的 Agent 咨询市场信息。Agent 使用 get_liquidation_levels 工具回答 BTC 多头头寸在 Hyperliquid 上会在哪里被清算。

服务:mcp.0xarchive.io 认证:OAuth 兼容:Claude · ChatGPT · Codex · Cursor 数据:Hyperliquid · Lighter

连接 · Agent 和客户端 · 数据 · 示例 · 故障排除

通过你的 Agent 查询 Hyperliquid 和 Lighter 的市场数据。使用只读市场数据工具获取当前和历史订单簿、交易、K 线、资金费率、未平仓量、清算、持仓和数据覆盖范围;授予 Webhook 访问权限后,还可以管理 Webhook。

亮点

  • 无需密钥,无需安装。 添加一个 URL,通过客户端的 OAuth 流程登录并批准读取权限。
  • 兼容所有支持 MCP 的客户端。 Claude Code、Claude 网页版和桌面版、ChatGPT、Codex、Cursor、VS Code、Antigravity 和 Gemini CLI;下方提供了每个客户端的设置步骤。
  • 涵盖两个交易平台的所有市场。 Hyperliquid Core 永续合约、HIP-3、HIP-4 和现货,以及主网和 Robinhood Chain 上的 Lighter。
  • 默认只读。 市场数据需要 mcp:market.read;只有同时授予 Webhook 作用域时,才会显示 Webhook 工具。

连接

服务 URL

https://mcp.0xarchive.io/mcp

将此 URL 添加为远程 HTTP MCP 服务,然后通过客户端的 OAuth 流程使用你的 0xArchive 账户登录。出现提示时批准 mcp:market.read 权限;如果需要 Webhook 工具,也请批准 mcp:webhooks.read 和 mcp:webhooks.write。无需 0xArchive API 密钥,也无需在本地安装 MCP 服务。

从以下请求开始:

获取 Hyperliquid 上的 BTC 市场摘要。

Agent 和客户端

如果你已经配置了 MCP 服务,可在不替换其他条目的情况下添加 0xArchive。

Claude Code
claude mcp add --transport http 0xarchive https://mcp.0xarchive.io/mcp

在 Claude Code 中运行 /mcp,选择 0xarchive,然后选择 Authenticate。在浏览器中完成登录,然后请求 BTC 市场摘要。

Claude Code MCP 文档

Claude 网页版、桌面版和 Cowork
  1. 在 Claude 中打开 Customize → Connectors。
  2. 点击 + → Add custom connector。
  3. 将其命名为 0xArchive,并输入 https://mcp.0xarchive.io/mcp。
  4. 添加连接器,点击 Connect,然后完成 OAuth 登录。
  5. 在对话中通过 + → Connectors 启用它。

对于 Team 和 Enterprise 工作区,所有者需要先在 Organization settings → Connectors 中添加连接器;随后每位成员连接自己的账户。

Claude 自定义连接器指南

ChatGPT
  1. 在 Settings → Security & Login 中启用 Developer mode。
  2. 打开 Plugins,并使用 + 按钮添加 MCP 连接。
  3. 将其命名为 0xArchive,输入 https://mcp.0xarchive.io/mcp,然后完成 OAuth 身份验证。
  4. 开始新对话,并通过 + → More 选择该连接。 ChatGPT MCP 连接指南
Codex CLI 和 IDE 扩展
codex mcp add 0xarchive --url https://mcp.0xarchive.io/mcp

完成 OAuth 登录。如需单独启动身份验证,请运行:

codex mcp login 0xarchive

CLI 和 IDE 扩展共用 MCP 配置。请在 Codex 终端界面中使用 /mcp 检查连接。

Codex MCP 文档

Cursor

将此条目添加到项目中的 .cursor/mcp.json。如需为用户范围配置连接,请使用 ~/.cursor/mcp.json。

{
  "mcpServers": {
    "0xarchive": {
      "url": "https://mcp.0xarchive.io/mcp"
    }
  }
}

打开 Cursor 的 MCP 设置,连接 0xarchive 并完成 OAuth 登录。为 Agent 启用此服务的工具。

Cursor MCP 文档

VS Code 和 GitHub Copilot

从命令面板运行 MCP: Add Server,选择 HTTP 服务,并输入 https://mcp.0xarchive.io/mcp。

或者将其添加到 .vscode/mcp.json:

{
  "servers": {
    "0xarchive": {
      "type": "http",
      "url": "https://mcp.0xarchive.io/mcp"
    }
  }
}

启动服务并完成浏览器 OAuth 流程。使用 MCP: List Servers 检查其状态,然后在聊天中启用所需工具。

VS Code MCP 文档

Antigravity CLI 和 Gemini CLI

对于个人 Google 账号,当前建议使用 Antigravity CLI。将以下内容添加到项目中的 .agents/mcp_config.json:

{
  "mcpServers": {
    "0xarchive": {
      "serverUrl": "https://mcp.0xarchive.io/mcp"
    }
  }
}

在 Antigravity CLI 中打开 /mcp,重新加载配置并检查服务。完成其 OAuth 身份验证提示。请使用 serverUrl,而不是 Gemini CLI 的 httpUrl 字段。

Gemini CLI 仍可通过 Gemini Code Assist Standard/Enterprise 许可证或付费 Google API 访问使用。在项目目录中:

gemini mcp add --transport http 0xarchive https://mcp.0xarchive.io/mcp

启动 Gemini 并运行:

/mcp auth 0xarchive

完成浏览器 OAuth 流程。/mcp 会显示服务及其可用工具。

Antigravity MCP 文档 · Gemini CLI MCP 文档 · Google 客户端可用情况

Grok 网页版和 Grok Build

Grok 网页版

  1. 打开 Grok Connectors。
  2. 选择 New Connector → Custom。
  3. 输入 https://mcp.0xarchive.io/mcp 并完成 OAuth 登录。
  4. 在对话中请求 0xArchive 市场数据。

对于 Business 和 Enterprise 组织,团队管理员需要先配置连接器。

Grok Build

grok mcp add --transport http 0xarchive https://mcp.0xarchive.io/mcp

首次使用该服务时,Grok 会启动 OAuth 流程。在终端界面中,/mcps 可打开 MCP 设置;按 i 可为所选服务启动身份验证。

Grok 连接器 · Grok Build MCP 文档

Hermes Agent
hermes mcp add --url https://mcp.0xarchive.io/mcp --auth oauth 0xarchive

使用你的 0xArchive 账号进行身份验证:

hermes mcp login 0xarchive

运行 hermes mcp test 0xarchive 检查连接。如果系统提示选择工具,请启用所需的市场和数据工具。

Hermes MCP 文档

OpenClaw

使用 OAuth 添加远程服务:

openclaw mcp set 0xarchive '{
  "url": "https://mcp.0xarchive.io/mcp",
  "transport": "streamable-http",
  "auth": "oauth",
  "oauth": {"scope": "mcp:market.read"}
}'

然后登录:

openclaw mcp login 0xarchive

运行 openclaw mcp doctor 0xarchive --probe 检查连接。使用 OpenClaw 的 MCP 工具控制项,选择哪些 Agent 或会话可以使用该服务。

OpenClaw MCP 指南 · OAuth 设置

OpenCode

将此条目添加到 opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "0xarchive": {
      "type": "remote",
      "url": "https://mcp.0xarchive.io/mcp",
      "enabled": true
    }
  }
}

进行身份验证:

opencode mcp auth 0xarchive

完成浏览器登录。opencode mcp list 会显示身份验证状态。 OpenCode MCP 文档

Windsurf 和 Devin

Devin Local 和 Devin CLI

Devin Local 是新编辑器标签页的默认 Agent,使用 Devin MCP 配置。在项目目录中运行:

devin mcp add 0xarchive https://mcp.0xarchive.io/mcp

然后进行身份验证:

devin mcp login 0xarchive

Cascade

如果使用 Cascade,请将以下内容添加到 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "0xarchive": {
      "serverUrl": "https://mcp.0xarchive.io/mcp"
    }
  }
}

打开 Cascade 的 MCP 设置,启用服务并完成 OAuth 登录。如果达到客户端的工具数量上限,请选择所需的工具。每个使用的客户端都需要单独登录。

Devin MCP 配置 · Windsurf/Cascade MCP 设置

Cline
  1. 打开 Cline 的 MCP 服务面板和 远程服务标签页。
  2. 将 0xarchive 输入为名称,并将 https://mcp.0xarchive.io/mcp 输入为 URL。
  3. 选择 Streamable HTTP,然后点击 添加服务。
  4. 服务请求 OAuth 时,点击 Authenticate,然后在浏览器中完成登录。

如果没有显示 Authenticate,请先更新 Cline,再进行连接。

Cline MCP 文档

其他 MCP 客户端

使用支持 Streamable HTTP 和 OAuth 的客户端连接到相同的服务 URL。让客户端发现授权服务器并完成登录。不要改用 API 密钥或手动粘贴的 bearer token。

对于自定义集成,服务会发布 OAuth 资源元数据。客户端流程请参阅 MCP 授权规范。

可查询内容

  • Hyperliquid 核心永续合约: 市场摘要、价格、交易、K 线、CVD、资金费率、未平仓合约、强平、L2 和 L4 订单簿、订单历史、订单流、触发订单、市场广度和钱包分类。
  • Hyperliquid 现货: 交易对发现、交易、K 线、订单簿、L4 快照和差异、订单历史、TWAP 记录和数据新鲜度。
  • HIP-3 builder 永续合约: 市场发现和摘要、交易、K 线、CVD、资金费率、未平仓合约、强平、L2 和 L4 订单簿、订单、市场广度、预言机外部价格和发现范围,以及钱包分类。xyz:SP500 等带有 builder 前缀的符号用于标识市场。
  • HIP-4 结果市场: 工具、结果和问题、价格、K 线、交易、未平仓合约、订单历史,以及 L2 和 L4 订单簿。
  • Lighter(主网和 Robinhood Chain): 市场发现和摘要、交易、K 线、资金费率、未平仓合约、强平和订单簿;主网上还提供 L3 订单簿。
  • 账户持仓: 按 Hyperliquid 钱包或 Lighter 账户索引查询当前和历史持仓、持仓变化及账户摘要,并可查看各市场的持仓列表。
  • Webhook: 在客户端以 Webhook 访问权限连接时,可查询端点、订阅、估算和模拟运行预览、监控的钱包以及投递日志。

Hyperliquid 核心市场和 HIP-3 还提供预计的强平价格水平和触发价格水平。数据质量工具可提供覆盖范围、新鲜度(包括账户持仓)、事件、延迟和状态信息。

例如:get_summary、get_hip3_instruments、get_spot_pairs、get_hip4_outcomes、get_lighter_l3_orderbook 和 get_symbol_coverage。连接后,客户端会发现可用工具及其输入架构。

交易场所和数据集覆盖范围 · MCP 工具示例 · 数据质量

示例请求

市场摘要

获取 Hyperliquid 上的 BTC 市场摘要。包含来源时间戳。

跨平台资金费率

分别获取 Hyperliquid 和 Lighter 当前的 BTC 资金费率。比较数值前,先显示各来源的单位和时间戳。

历史 K 线

获取过去 24 小时 Hyperliquid 上的 ETH 一小时 K 线。总结价格范围和交易量。

Builder 市场

查找 HIP-3 市场 xyz:SP500,并获取其当前摘要和订单簿。

现货市场

查找 Hyperliquid 上的 HYPE 现货交易对,然后获取匹配交易对的近期交易记录。

结果市场

列出尚未结算的 HIP-4 结果市场。显示其中一个市场的问题和当前价格。

订单级数据

获取 Lighter 上当前的 BTC L3 订单簿,并显示买盘和卖盘的最优报价。

历史数据覆盖范围

检查 Hyperliquid 上过去 24 小时的 BTC 数据覆盖范围,并列出该时间段内记录的任何数据事件。

使用历史数据

指定交易平台、市场和 UTC 时间区间。查询较长时间范围的历史数据时,请使用较短的时间窗口;如果返回游标,请继续分页。如果响应过大,请缩小请求范围,不要将返回的部分数据当作完整数据集。

保留数值对应的时间戳和来源单位,尤其是在比较不同平台的资金费率时。使用市场发现工具解析交易品种,并使用覆盖范围工具查找可用的历史数据。

如需批量 Parquet 文件,请使用 Data Catalog。如需连续的市场数据流,请使用 WebSocket API。

账户与访问权限

使用 0xArchive 账户登录。数据访问权限和使用限制由你的 0xArchive 套餐决定;AI 客户端自身的订阅和自定义连接器权限则另行计算。

故障排除

问题检查事项
客户端打开文档或报告服务器响应无效使用完整 URL https://mcp.0xarchive.io/mcp,包括 /mcp,并选择 HTTP,而不是 stdio。
登录失败或服务器返回 401通过客户端的 OAuth 流程重新连接。移除手动配置的 API 密钥或授权请求头。
客户端提示 0xArchive 已存在编辑或重新连接现有服务器条目,不要重复添加。
连接成功,但工具不可用检查客户端的 MCP 启用状态和工具选择;更改配置后,刷新或重启客户端。
找不到市场使用相应的交易品种、现货交易对或结果市场发现工具。保留 Builder 前缀和符号大小写。
历史请求无结果或被拒绝检查该市场记录的数据覆盖范围,以及套餐允许的历史数据时间范围。
请求超时或返回数据过多缩短时间区间、在可用时减少请求的页面大小,或使用 Parquet 导出批量数据集。
请求受到速率限制等待重试间隔结束,并在重试前检查套餐的使用限制。

帮助

请勿在提示词和公开议题中泄露访问令牌、API 密钥及账户私人信息。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。