关于 Hive Swap
Hive Swap 是只读 MCP 服务,可在 Base 上请求 Paraswap 实时报价,适合需要获取报价和路由信息、但不执行交易的 Agent 与客户端。
主要功能
- 01获取 Paraswap 实时报价
- 02支持 ETH、WETH、USDC 和 USDT
- 03接受 Base 代币地址
- 04不执行交易或托管资金
适用场景
- 01交易前查询 Base 兑换报价
- 02向 Agent 提供价格数据
- 03查看可用的路由场所
MCP 相关
通过 MCP 提供 `swap_route.quote` 工具,同时提供 HTTP 报价端点。报价仅供参考,不支持构建、签名或提交交易。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://hive-mcp-swap.onrender.com/mcpclaude mcp add --transport http srotzin-hive-mcp-swap https://hive-mcp-swap.onrender.com/mcp{"mcpServers":{"srotzin-hive-mcp-swap":{"type":"http","url":"https://hive-mcp-swap.onrender.com/mcp"}}}在 Cursor 中打开{"servers":{"srotzin-hive-mcp-swap":{"type":"http","url":"https://hive-mcp-swap.onrender.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"srotzin-hive-mcp-swap":{"type":"http","url":"https://hive-mcp-swap.onrender.com/mcp"}}}{"mcpServers":{"srotzin-hive-mcp-swap":{"serverUrl":"https://hive-mcp-swap.onrender.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
1| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| tokenIn | string | 是 | Base 上的输入代币符号。可选值:ETH、WETH、USDC、USDT。 |
| amountIn | number | 是 | 输入代币数量。必须大于 0。 |
| tokenOut | string | 是 | Base 上的输出代币符号。可选值:ETH、WETH、USDC、USDT。 |
详细介绍
hive-mcp-swap
Base 上只读的 Paraswap 价格报价。
在线合约
此 MCP 服务提供一项 swap 能力:
| 接口 | 用途 |
|---|---|
GET /v1/swap-route/quote | 请求 Base 上的实时 Paraswap 价格报价 |
swap_route.quote | 通过 MCP 请求相同的报价 |
响应会将 Paraswap 标识为提供方,并保留返回路线中包含的交易场所名称。Hive 不会构建、签名、提交或结算交易,也不会收取路由费用、运营流动性或托管资金。
支持的代币符号包括 ETH、WETH、USDC 和 USDT。调用方也可以提供 Base 代币地址。金额必须为正数。
失败行为
如果 Paraswap 未返回可用报价,HTTP 端点会返回 502 和 no_route_available。MCP 工具会返回结构化错误负载。未知 HTTP 路径返回 404。未知 MCP 工具和方法会返回 JSON-RPC 错误。
没有交易执行端点,也没有交易构建端点。报价响应不包含信任评分、AML 筛查或收据签名声明。
发现
| 方法 | 路径 | 描述 |
|---|---|---|
GET | /health | 本地存活状态和已声明的能力 |
POST | /mcp | MCP JSON-RPC 2.0,协议版本 2024-11-05 |
GET | /.well-known/mcp.json | MCP 发现清单 |
GET | /.well-known/agent.json | Agent 卡片 |
GET | /.well-known/security.txt | 安全联系信息 |
GET | /llms.txt | 纯文本集成指南 |
GET | /og.svg | 服务图片 |
示例
GET https://mcp-swap.thehiveryiq.com/v1/swap-route/quote?tokenIn=ETH&tokenOut=USDC&amountIn=1
此报价仅供参考。若调用方选择进行交易,必须自行使用自己的钱包和执行提供方构建、审查、签名并提交交易。
测试
npm install
npm test
自动化测试套件会验证清单一致性、移除先前的执行接口、对未知路由进行如实处理,以及不包含未经支持的提供方、费用、结算、AML 和信任声明。另有一项独立的实时探测,用于验证 Paraswap 能否返回当前的 Base 报价。
目录
Hive Civilization。品牌金色 #C08D23。Steve Rotzin。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。