关于 1inch-mcp-server
用于连接 1inch MCP 服务的中心技能,并根据任务选择相应的 1inch 领域技能。它说明可用工具、认证步骤和客户端配置方式。
主要功能
- 01按任务对应领域 Skill
- 02列出服务工具及访问要求
- 03说明认证流程
- 04提供客户端连接配置指引
- 05介绍基于钱包的签名行为
适用场景
- 01为 1inch MCP 服务配置客户端
- 02选择用于兑换或限价单的 Skill
- 03查找钱包和市场数据工作流
- 04配置 WalletConnect 签名
MCP 相关
它将客户端连接到文档所列的 Streamable HTTP 端点,并提供 Claude Desktop 的 stdio 选项。该服务向客户端提供兑换、订单、产品 API、文档搜索和认证工具,以及可选的 WalletConnect、Aqua 和调试功能。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ 1inch/ 1inch-ai --skill 1inch-mcp-server安装后在 Claude Code 中输入/1inch-mcp-server确认已加载。
附带文件references/AUTH.mdreferences/TOOLS.md
详细介绍
1inch MCP 服务
用于接入 1inch MCP 服务的中心技能。配套的领域技能介绍具体工作流:
| 技能 | 适用场景 |
|---|---|
1inch-swap | 经典兑换、Fusion 兑换/跨链兑换 |
1inch-orderbook | 限价订单 |
1inch-wallet-data | 通过 product_api 查询投资组合、余额、历史记录、NFT 和代币元数据 |
1inch-market-data | 通过 product_api 查询现货价格、Gas 价格和图表 |
1inch-infrastructure | 通过 product_api 使用 Web3 RPC、交易网关和域名服务 |
1inch-walletconnect | 配对非托管钱包 |
1inch-aqua | Aqua 策略分析 |
1inch-debug | 按组织范围查询请求日志 |
服务 URL(生产环境)
https://api.1inch.com/mcp/protocol(Streamable HTTP)
工具概览
| 工具 | 身份验证 | 用途 |
|---|---|---|
search | 公开 | 搜索 1inch 文档和 API 参考 |
list_examples / get_example | 公开 | SDK 示例包 |
authenticate | 已验证身份 | 开始或确认 1inch Business 登录 |
swap | 已验证身份 | 报价和执行兑换 |
orderbook | 已验证身份 | 构建/创建/列出/取消限价订单 |
product_api | 已验证身份 | 调用其他 1inch 产品 API |
walletconnect | 公开(可选) | 通过 WalletConnect 配对/签名/发送 |
aqua | 公开读取(可选) | Aqua 策略分析 |
debug | 已验证身份(可选) | 按组织范围查询请求日志 |
完整参数:references/TOOLS.md。身份验证:references/AUTH.md。
初始化时收到 HTTP 200 仍表示匿名。使用付费工具前,请调用 authenticate;如果收到 HTTP 401,请完成 OAuth,然后再次调用 authenticate。
**签名流程:**如果 walletconnect 工具可用,请优先连接用户的钱包;之后,swap、orderbook 和 aqua 的写入操作默认通过已连接的钱包执行(execute 默认为 true),用户只需在钱包应用中批准提示。请参阅 1inch-walletconnect 技能。
客户端配置(摘要)
| 客户端 | 传输方式 | 配置 |
|---|---|---|
| Cursor | HTTP | Marketplace 插件 Setup → Edit Values,或 .cursor/mcp.json |
| VS Code Copilot | HTTP | .vscode/mcp.json → type: "http",使用相同 URL |
| Claude Code / Codex / Gemini CLI | HTTP | 使用 --transport http 运行 CLI mcp add |
| Claude Desktop | stdio | npx -y supergateway --streamableHttp <URL> --outputTransport stdio |
渐进式披露
任务符合上述某个领域技能的适用场景时,请加载该技能。如果 product_api 路径返回 404,请获取 file://1inch-mcp/guides/api-index,或调用 search。