关于 THORChain Swap
THORChain Swap 是 THORChain 与 Maya Protocol 跨链兑换界面的开发者资源项目。其公开 MCP 服务提供只读的兑换报价、流动性池和网络信息工具。
主要功能
- 01提供兑换报价工具
- 02查询流动性池信息
- 03查询网络状态
- 04支持 MCP Apps
- 05提供 REST API 文档和 OpenAPI 规范
适用场景
- 01查询跨链兑换报价
- 02查看流动性池数据
- 03检查网络状态
MCP 相关
公开 MCP 服务位于 `/mcp`,向 MCP 客户端提供兑换报价、流动性池和网络相关工具。服务无需密钥或 OAuth,采用匿名且受速率限制的访问。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://swap.thorchain.org/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http org-thorchain-swap-thorchain-swap https://swap.thorchain.org/mcpCursor.cursor/mcp.json
{"mcpServers":{"org-thorchain-swap-thorchain-swap":{"type":"http","url":"https://swap.thorchain.org/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"org-thorchain-swap-thorchain-swap":{"type":"http","url":"https://swap.thorchain.org/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"org-thorchain-swap-thorchain-swap":{"type":"http","url":"https://swap.thorchain.org/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"org-thorchain-swap-thorchain-swap":{"serverUrl":"https://swap.thorchain.org/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
3| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| amount | string | 是 | 要兑换的金额,以 1e8 基本单位计 |
| to_asset | string | 是 | 目标资产,例如 ETH.ETH |
| from_asset | string | 是 | 源资产,例如 BTC.BTC |
| destination | string | 否 | 可选的目标地址;若要获取可用 memo 的报价,则为必填 |
| streaming_interval | string | 否 | 可选的流式兑换区块间隔 |
详细介绍
THORChain Swap
由 THORChain 和 Maya Protocol 提供支持的原生跨链兑换官方网页界面,现已上线:swap.thorchain.org。
直接在不同链之间交易 Bitcoin、Ethereum、稳定币和其他 layer-1 资产:无需桥接、包装代币、订单簿或用户账户。用户可以连接自己的钱包并在本地签署交易,也可以完全不连接钱包,通过无备注(“即时”)兑换进行兑换。
THORChain 开发者资源
面向兑换界面的 THORChain 开发者资源——API 文档、OpenAPI 规范、身份验证文档和 MCP 服务:
- 开发者门户 — 索引(Markdown:/developers.md)
- 快速入门 — 无需 API 密钥,只需一个请求即可获取首个兑换报价
- REST API 参考 — 端点、错误格式、幂等性、版本控制、沙盒
- MCP 服务参考 — 工具、参数架构、MCP Apps、速率限制
- 身份验证 — 此处无需身份验证;了解聚合器 API 密钥的获取方式
- SDK — 用于构建兑换的
@tcswap/sdk,以及面向无需密钥的公共接口的 Python (sdk/python) 和 Go (sdk/go) 客户端 - Webhook 和事件轮询 — 了解如何在没有 Webhook 的情况下跟踪兑换状态
- OpenAPI 3.1 描述 — 公共 REST API
- MCP 服务 — 位于
/mcp的公共 Model Context Protocol 服务,提供兑换报价、池和网络工具(支持 MCP Apps) - 身份验证模型 — 匿名、受速率限制的公共访问;MCP 服务无需密钥、令牌或 OAuth,并可通过联盟计划免费获取聚合器 API 密钥
AI Agent 资源
- llms.txt — Agent 资源索引,附有使用时机指南
- Agent 资源库 — 完整的单文件参考(URL 方案、MCP 示例、资产表示法、报价语义、安全规则)
- AGENTS.md — 使用此网站的 Agent 指南和安全规则
AGENTS.md(仓库根目录)— 面向在此代码库上工作的 AI 编码 Agent 的说明
开发
npm install
npm run dev
打开 http://localhost:3000。将 .env.example 复制为 .env 并填写 API 密钥。使用
npx tsc --noEmit -p tsconfig.json 进行类型检查。
请参阅 AGENTS.md,了解架构说明、关键路径和约定。
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。