Ophis MCP

@ophis/mcp-server

面向 Agent 的 MCP 服务，用于 Ophis DEX，通过 Cloudflare Worker 部署，采用 Streamable-HTTP 传输方式，地址为 https://mcp.ophis.fi/mcp。

当前服务版本：v0.2.0，包含 13 个工具，覆盖 15 条已配置的 EVM 链（14 条主网和 Sepolia）。

它向自主 Agent 和 MCP 客户端开放 Ophis 的交易功能，无需它们重新推导该分叉中那些不易察觉、容易出错的细节（Ophis 运营链上的非规范结算合约、自托管的 Optimism、Unichain、Robinhood Chain 和 Arc 订单簿主机、CIP-75 合作伙伴费用的 appData 格式，以及接收方固定）。

Arc（5042）收取 1 bp 基础费用，并支持路由交易量索引和推荐归因。服务会应用默认推荐设置；单次调用时提供的代码会覆盖默认值，空字符串则表示不参与。订单被接受后，submit_order 会将所有者加入索引和正在进行的交易奖励活动。

这些工具适用于已配置的 EVM 订单簿。list_chains 报告的是配置信息，而非实时可用性探测。独立应用中由外部注资的 NEAR 资金来源流程是单独的；这些工具不会创建或注资此类存款。 请参阅网络和资金覆盖范围。

安全模型

服务不持有私钥，也绝不会签名。build_order 返回一个范围受限、可直接签名的 EIP-712 负载，并将订单接收方固定为所有者（这是自主 Agent 被盗资产的头号途径）；Agent 使用自己的密钥签名并提交。这是 V1“范围受限的能力”模式，是一种链下防滥用措施，并非链上授权边界。服务公开且无需认证：所有后端端点本就公开，且这些工具只能读取和构建数据。

工具

工具	用途
parse_intent	将自然语言交换请求转换为结构化意图（通过 swap.ophis.fi/api/intent 调用 LibertAI Qwen）。
resolve_token	从可信的 Ophis 列表中将代币符号解析为其规范地址；无法确认时会失败关闭（防伪）。
list_chains	支持的链、订单簿主机、结算合约和合作伙伴费用配置。
get_quote	从链对应的 Ophis 订单簿获取最佳执行报价（/api/v1/quote）。
expected_surplus	以基点估算相较于公开聚合器（KyberSwap）的价格改善幅度。
build_order	范围受限、可直接签名的 CoW 订单：使用正确的链对应结算合约和订单簿，在 appData 中包含 CIP-75 合作伙伴费用，并将接收方固定为所有者。
submit_order	将已预先签名的订单中继至订单簿（/api/v1/orders）。此处不持有密钥。
get_integrator_earnings	按 appCode 查询 CoW 托管链上的路由交易量、Ophis 基础费用和集成方自身费用（rebates.ophis.fi/earnings/:appCode）。
get_balances	查询某条链上某地址的原生代币和 ERC-20 余额。
get_portfolio	查询多条链上的原生代币和 ERC-20 余额。
get_gas	查询链的当前 Gas 价格（仅供参考；链下订单签名无需 Gas，但授权和其他钱包交易需要）。
get_token_chart	查询代币的 OHLCV 价格历史。
validate_order	对外部构建的订单进行离线预检（无需网络和密钥）：检查 appCode、订单簿主机、EIP-712 域、appData 哈希是否匹配、接收方是否固定，以及订单是否已过期或费用是否非零。

Agent 典型流程

parse_intent("swap 100 USDC for WETH on Optimism")
  → resolve_token({ chainId, symbol }) for BOTH the sell and buy symbols   // canonical addresses, fails closed (anti-spoof); for a native-coin request like ETH, resolve the wrapped symbol (WETH)
  → get_quote({ chainId, sellToken, buyToken, kind:'sell', amount, from })
  → build_order({ chainId, owner, sellToken, buyToken, sellAmount, buyAmount /* slippage-adjusted */, kind })
  → (agent confirms with the user, then signs `order` as EIP-712 using `signing`)
  → submit_order({ chainId, order, signature, from, fullAppData })

开发

pnpm --filter @ophis/mcp-server test         # unit tests (pure logic)
pnpm --filter @ophis/mcp-server typecheck
pnpm --filter @ophis/mcp-server dev          # wrangler dev (local Streamable HTTP)
npx @modelcontextprotocol/inspector@latest   # point at http://localhost:8787/mcp

dev / deploy / dry-run 会先自动构建工作区 SDK（pre* 脚本），因此干净的代码检出无需手动构建 @ophis/sdk 即可使用。

部署

推送到 main 时，通过 .github/workflows/mcp-deploy.yml 自动部署，使用权限最小化的 CLOUDFLARE_WORKERS_TOKEN 密钥（仅限 Workers Scripts 和 Routes）。手动部署：

pnpm --filter @ophis/mcp-server deploy        # builds the SDK, then wrangler deploy → mcp.ophis.fi

自定义域名 mcp.ophis.fi 根据 wrangler.jsonc（routes）配置。

main 部署成功后，组织管理员会创建匹配的 mcp-v<x.y.z> 标签。.github/workflows/mcp-registry-release.yml 会验证线上 /health 版本是否匹配，然后将 server.json 发布到官方 MCP Registry。请参阅发布操作手册。