Mcp Server For Ai To Blockchain Interactions — Balances, Swaps, Transfers, Gas, Prices. Non Custodial. Multi Chain.

Name: Mcp Server For Ai To Blockchain Interactions — Balances, Swaps, Transfers, Gas, Prices. Non Custodial. Multi Chain.
Author: y0exchange

本地服务

github.com/y0exchange金融数据733 周前更新

代码仓库

关于 Mcp Server For Ai To Blockchain Interactions — Balances, Swaps, Transfers, Gas, Prices. Non Custodial. Multi Chain.

@y0exchange/mcp 是面向 AI Agent 的多链 DeFi MCP 服务，提供资产查询、报价及交易构建。写操作仅生成未签名交易，由用户在自己的设备上签署，私钥不交给服务端。

主要功能

01查询余额与跨链投资组合
02获取价格、Gas 和兑换报价
03查看交易历史
04构建未签名兑换与转账交易
05支持 Ethereum、BNB Chain、Arbitrum、Base 和 Polygon

适用场景

01查看各链资产及美元估值
02比较兑换报价和 Gas 成本
03在设备签署前准备兑换或转账交易

MCP 相关

作为 MCP 服务，通过 stdio 或 Streamable HTTP 向 MCP 客户端提供 DeFi 查询与交易构建工具。读操作无需 API 密钥；兑换和转账需要 Y0_API_KEY，并生成由用户签署的未签名交易。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "y0exchange": {
      "command": "npx",
      "args": [
        "-y",
        "@y0exchange/mcp"
      ],
      "env": {
        "Y0_API_KEY": "<Y0_API_KEY>"
      }
    }
  }
}

启动命令npx -y @y0exchange/mcp

需要配置的环境变量

Y0_API_KEY密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@y0exchange/mcpstdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
address	string	否	钱包地址（0x...）。配置了 API 密钥时可选。
chainId	number	否	链 ID（默认：Ethereum 为 1）。支持：1、56、42161、8453、137

详细介绍

@y0exchange/mcp

让 AI agents 交易加密货币。非托管。多链。一个 MCP 服务。

这是什么？

@y0exchange/mcp 是一个 Model Context Protocol 服务，可让 AI agents 实时访问 DeFi 信息——余额、价格、Gas、兑换报价、交易历史，并能够执行兑换和转账。

将其连接到 Claude、ChatGPT 或任何兼容 MCP 的 AI 客户端。用户与 AI 对话，AI 与区块链交互。

User  →  AI Agent  →  @y0exchange/mcp  →  Blockchain
                            ↓
                     y0 Signing Service (user signs on their device)

天生非托管。 y0 绝不会接触私钥。写入操作会构建未签名的交易，用户始终在自己的设备上签名。

快速开始

1. 获取 API 密钥

2. 添加连接器（推荐）

最简单的方式——适用于 Claude Desktop、claude.ai、Claude Mobile 和 ChatGPT：

打开 AI 应用 → Settings → Connectors → Add custom connector
名称：y0
URL：https://mcp.y0.exchange/mcp?key=YOUR_API_KEY
保存——完成！

无需安装、无需配置文件、无需终端。API 密钥会关联到你的钱包——AI agent 会自动获知你的地址和权限。

开发者 IDE（Cursor、Windsurf）

添加到你的 MCP 配置中（例如 .cursor/mcp.json）：

{
  "mcpServers": {
    "y0": {
      "command": "npx",
      "args": ["-y", "@y0exchange/mcp"],
      "env": {
        "Y0_API_KEY": "y0_your_api_key_here"
      }
    }
  }
}

Claude Code

claude mcp add --transport http y0 https://mcp.y0.exchange/mcp?key=YOUR_API_KEY

任意 MCP 客户端（stdio）

Y0_API_KEY=y0_... npx @y0exchange/mcp

服务通过 stdio 通信——兼容任何 MCP 客户端。

只读模式

即使没有 Y0_API_KEY，只读工具（余额、价格、Gas、报价、历史记录）仍可使用。不提供密钥即可在没有账户的情况下进行体验。

远程服务（HTTP）

托管在 mcp.y0.exchange 的远程服务为上述连接器方式提供支持。你也可以自行托管。

自托管远程服务

# Build
pnpm --filter @y0exchange/mcp build

# Run
pnpm --filter @y0exchange/mcp start:remote

# Or with Docker
docker build -f mcp/Dockerfile -t y0-mcp-remote .
docker run -p 3100:3100 \
  -e SIGNING_SERVICE_URL=https://api.y0.exchange \
  -e ZEROX_API_KEY=your_key \
  y0-mcp-remote

远程服务提供：

POST /mcp — Streamable HTTP MCP 端点
GET /health — 健康检查

环境变量 PORT 用于设置监听端口（默认值：3100）。

与 stdio 的区别

	stdio（`npx`）	远程（HTTP）
运行位置	用户的计算机	你的服务
传输方式	stdin/stdout	Streamable HTTP
支持移动设备	否	是
支持 claude.ai	否	是
身份验证	`Y0_API_KEY` 环境变量	URL 中的 `?key=` 或 `Authorization` 标头
部署方式	无（npm）	Docker / 任意 Node.js 主机

工具

只读——开箱即用，无需 API 密钥

工具	描述
`get_balance`	任意钱包的原生代币和 ERC-20 代币余额
`get_portfolio`	汇总所有链上的投资组合，并显示 USD 价值
`get_price`	实时代币价格及 24 小时涨跌幅
`get_quote`	兑换报价，包含路由预览、费用和 Gas 估算
`get_gas`	各链的 Gas 价格及 USD 成本估算
`get_history`	带智能分类的交易历史

写入——需要 `Y0_API_KEY`

工具	描述
`swap`	构建未签名的兑换交易 → 用户在设备上批准
`send`	构建未签名的转账交易 → 用户在设备上批准

写入工具使用你的 API 密钥来识别你的钱包。AI Agent 无需询问你的地址——系统会根据密钥自动解析。

支持的链

链	ID	状态
Ethereum	`1`	生产环境
BNB Chain	`56`	生产环境
Arbitrum	`42161`	生产环境
Base	`8453`	生产环境
Polygon	`137`	生产环境

配置

所有配置均通过环境变量进行。只读工具无需任何必填项。

核心配置

变量	描述	默认值
`Y0_API_KEY`	你的 y0 API 密钥（兑换／发送操作必需）	—
`SIGNING_SERVICE_URL`	y0 签名服务端点	`https://api.y0.exchange`

兑换服务商

变量	描述
`ZEROX_API_KEY`	0x 兑换 API 密钥（优先尝试）
`ONEINCH_API_KEY`	1inch 兑换 API 密钥（备用）

区块浏览器（用于 `get_history`）

变量	描述
`ETHERSCAN_API_KEY`	Etherscan API 密钥
`BSCSCAN_API_KEY`	BSCScan API 密钥
`ARBISCAN_API_KEY`	Arbiscan（备用时使用 Etherscan 密钥）
`BASESCAN_API_KEY`	BaseScan（备用时使用 Etherscan 密钥）
`POLYGONSCAN_API_KEY`	PolygonScan（备用时使用 Etherscan 密钥）

定价

变量	描述
`COINGECKO_API_KEY`	CoinGecko Pro 密钥（可选，免费套餐也可用）

兑换的工作原理

1. User says: "Swap 1 ETH to USDC"

2. AI calls get_quote → shows price, fees, slippage

3. User confirms → AI calls swap (no wallet address needed — resolved from API key)

4. MCP authenticates with y0 Signing Service via Y0_API_KEY
   → builds unsigned transaction
   → sends push notification to user's mobile app

5. User reviews and signs on their device (biometric + wallet)

6. Transaction executes on-chain

你的密钥绝不会离开设备。 MCP 服务和 y0 签名服务仅处理未签名的交易数据。

对话示例

“我的投资组合价值多少？”

AI 调用 get_portfolio → 返回按链分类的明细、代币分配情况及 USD 总价值

“现在在 Base 上进行兑换需要多少 Gas？”

AI 使用 chainId 8453 调用 get_gas → 返回 Gas 价格，以及不同交易类型的 USD 预估费用

“在 Arbitrum 上把 500 USDC 兑换成 ETH”

AI 调用 get_quote → 显示预期输出 → 用户确认 → swap 构建未签名交易 → 用户签名

“向 vitalik.eth 发送 0.5 ETH”

AI 调用 send → 构建未签名转账 → 用户在设备上签名

技能：更智能的 DeFi 工作流

MCP 服务让 Claude 能够使用 DeFi 工具。y0 DeFi 技能教 Claude 如何更好地使用这些工具——在兑换前检查余额、提醒 Gas 费用、推荐最佳链，并自动遵循 DeFi 最佳实践。

新增内容

兑换前安全检查（余额、Gas、滑点建议）
投资组合分析，并提示集中度风险
跨链 Gas 比较和路由建议
任何写入操作前的确认关卡
领域专业知识：稳定币滑点、原生代币储备、测试交易建议

安装技能

Claude.ai：

下载 skill.zip
前往 Settings → Capabilities → Skills
点击 Upload skill，并选择下载的 skill.zip
确保 y0 MCP 连接器也已连接

Claude Code：

# Place the skill folder in your Claude Code skills directory
cp -r skill/ ~/.claude/skills/y0-defi-assistant/

验证是否正常工作

向 Claude 询问：“检查我的加密货币投资组合”——它应自动调用 get_portfolio，清晰地展示明细，并指出任何集中度风险或 Gas 优化机会。

面向 B2B 合作伙伴

正在构建 AI 驱动的交易产品？y0 提供所需的基础设施：

MCP 服务 — 本软件包，可接入任何 AI Agent
Signing UI — 可贴牌的交易审批组件
Signing Service — 用于交易构建和生命周期管理的托管后端
B2B Portal — API 密钥、使用情况仪表盘、账单

联系我们，设置集成。

架构

┌───────────────────────────────────────────────────────────┐
│                    AI Agents                               │
│  Claude Desktop / Claude Code / Cursor / GPT / custom     │
│  claude.ai / Claude Mobile                                │
└──────────┬───────────────────────────────┬────────────────┘
           │ stdio (local)                 │ HTTP (remote)
           │ npx @y0exchange/mcp           │ .../mcp?key=YOUR_API_KEY
           ▼                               ▼
┌──────────────────────────────────────────────────────────┐
│                   @y0exchange/mcp                         │
│                                                          │
│  ┌─────────────────┐  ┌──────────────────┐               │
│  │   Read Tools     │  │   Write Tools    │               │
│  │                  │  │                  │               │
│  │  get_balance     │  │  swap ─────────────► y0 Signing  │
│  │  get_portfolio   │  │  send ─────────────► Service     │
│  │  get_price       │  │                  │               │
│  │  get_quote       │  └──────────────────┘               │
│  │  get_gas         │                                     │
│  │  get_history     │                                     │
│  └────────┬─────────┘                                     │
└───────────┼───────────────────────────────────────────────┘
            │
   ┌────────▼─────────┐
   │   Blockchain RPCs │
   │   CoinGecko API   │
   │   0x / 1inch APIs │
   │   Block Explorers │
   └───────────────────┘

Mobile / Web (claude.ai, Claude Mobile):
  Uses remote HTTP server — no local process needed.

Desktop / CLI (Claude Desktop, Claude Code, Cursor):
  Can use either stdio (npx) or remote HTTP.

开发

# Clone the monorepo
git clone https://github.com/y0exchange/y0exchange.git
cd y0exchange

# Install dependencies
pnpm install

# Build
pnpm --filter @y0exchange/mcp build

# Run stdio server (local dev)
pnpm --filter @y0exchange/mcp start

# Run remote HTTP server (local dev)
pnpm --filter @y0exchange/mcp start:remote

# Watch mode (rebuilds on change)
pnpm --filter @y0exchange/mcp dev

许可证

MIT — 可在你的产品中自由使用。详情请参阅 LICENSE。

由 y0.exchange 构建 — 原生面向 AI 的 DeFi 基础设施

支持 Markdown

登录后评论

基本信息

作者: y0exchange
传输方式: stdio
收录时间: 2026年3月10日
最近更新: 33 周前

报告问题

第一次接触 MCP？

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

阅读入门指南

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