Lucyd

Name: Lucyd
Author: lucyd.trade

远程服务

lucyd.trade金融数据02 天前更新

代码仓库访问官网

关于 Lucyd

Lucyd 是用于浏览和交易 Bitcoin Up/Down 预测市场的 MCP 服务，运行于 Ethereum Sepolia 测试网。它为 AI Agent 和 MCP 客户端提供市场数据；配置钱包密钥后还可管理订单与持仓。

主要功能

01浏览市场和订单簿
02查看交易与钱包持仓
03提交限价单和市价单
04平仓并取消订单
05赎回已结算市场的收益

适用场景

01查看市场和订单簿
02进行测试网 Up/Down 交易
03查询持仓和收益历史
04取消订单或领取收益

MCP 相关

该服务向 MCP 客户端提供市场、订单簿、交易、钱包和交易操作工具。托管端点为只读；交易工具需要本地运行服务并配置钱包密钥。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://mcp.lucyd.trade/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http trade-lucyd https://mcp.lucyd.trade/mcp

Cursor.cursor/mcp.json{"mcpServers":{"trade-lucyd":{"type":"http","url":"https://mcp.lucyd.trade/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"trade-lucyd":{"type":"http","url":"https://mcp.lucyd.trade/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"trade-lucyd":{"type":"http","url":"https://mcp.lucyd.trade/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"trade-lucyd":{"serverUrl":"https://mcp.lucyd.trade/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

安装包

npm@lucyd/mcp0.1.3stdio

工具

详细介绍

Lucyd MCP 服务

将 AI Agent（Claude、Cursor 或任何 MCP 客户端）连接到预测市场交易所 Lucyd。用自然语言浏览市场、读取订单簿、交易、平仓并领取收益。

Lucyd 目前运行在 Ethereum Sepolia 测试网上，使用测试版 USDC。

功能

工具	功能
`list_markets`	按状态和周期筛选市场
`get_market`	单个市场：规则、行权价、结束日期、结果代币 ID
`get_order_book`	某个结果的买单和卖单、最高买价、最低卖价、中间价
`list_trades`	按市场或交易者查看近期交易
`get_positions`	持有的代币、平均价格、价值和利润
`get_trader_stats`	钱包的利润、交易量、胜率
`get_pnl_history`	随时间变化的利润
`top_traders`	排行榜
`get_status`	服务、结算和实时交易是否正常
`get_wallet`	你的地址、ETH 和 USDC 余额、授权情况
`get_open_orders`	你的挂单
`get_order_history`	你过去和当前的订单及其状态和成交情况
`place_order`	限价单或市价单（买入或卖出看涨或看跌代币）
`close_position`	立即卖出你在某个市场持有的全部代币
`cancel_orders`	按 ID、取消某个市场上的全部订单，或取消全部订单
`approve_trading`	一次性授权 Exchange 合约
`set_auto_redeem`	开启或关闭自动领取收益
`redeem`	领取已结算市场的收益

示例请求：

“显示开放的 1h 市场和当前市场的订单簿”
“在当前 15m 市场以 0.55 或更优的价格买入 10 个看涨代币”
“平掉我在 5m 市场的仓位”
“我本周有哪些仓位？总利润是多少？”
“取消我的所有订单”

没有钱包密钥时，服务以只读模式运行：可查看市场、订单簿、交易记录以及任何钱包的公开统计数据。

托管版，只读

仅查看市场数据，无需安装：在 Claude、ChatGPT 或任何支持 Streamable HTTP 的客户端中，将 https://mcp.lucyd.trade/mcp 添加为自定义连接器（远程 MCP 服务，无需身份验证）。它提供市场数据工具：市场、订单簿、交易记录，以及任意钱包地址的仓位和统计数据。交易需要你自己的钱包密钥，因此只能通过下方的本地服务进行。

若要运行自己的托管副本，请设置 LUCYD_HTTP_ADDR（例如 0.0.0.0:3006）和 LUCYD_HTTP_HOSTS（服务响应的主机名）；随后服务会在 /mcp 提供 MCP，并拒绝在设置钱包密钥时启动。

安装

最简单的方式只需安装 Node.js 18 或更高版本：客户端运行 npx -y @lucyd/mcp，首次运行时会下载适用于你系统的二进制文件并校验其 SHA-256。无需安装其他内容，配置见下文。

如果没有 Node.js，可从 data.testnet.lucyd.trade/mcp 下载适用于你系统的二进制文件（打开最新版本文件夹；其中的 SHA256SUMS 列出了校验和），并将其放在任意位置，例如 ~/bin/lucyd-mcp（Windows 上为 lucyd-mcp.exe）。在 macOS 和 Linux 上，使用 chmod +x lucyd-mcp 赋予其可执行权限。然后在下方配置中使用其路径代替 npx。

或者使用 Rust 从源代码构建：

cargo install --git https://github.com/lucyd-trade/mcp-server

连接你的 Agent

将密钥替换为你的交易钱包密钥。之后重启客户端。

Claude Code

claude mcp add lucyd -e LUCYD_PRIVATE_KEY=0xYOUR_KEY -- npx -y @lucyd/mcp

Claude Desktop：编辑 claude_desktop_config.json（macOS：~/Library/Application Support/Claude/，Windows：%APPDATA%\Claude\）。

Cursor：编辑 ~/.cursor/mcp.json。

两者使用相同的格式：

{
  "mcpServers": {
    "lucyd": {
      "command": "npx",
      "args": ["-y", "@lucyd/mcp"],
      "env": {
        "LUCYD_PRIVATE_KEY": "0xYOUR_KEY"
      }
    }
  }
}

如果 Windows 上的客户端无法启动 npx，请使用 "command": "cmd" 和 "args": ["/c", "npx", "-y", "@lucyd/mcp"]。

首次交易前

钱包需要 USDC 用于买入，还需要少量 Sepolia ETH，用来支付一次性授权和赎回的 Gas 费。然后让 Agent 检查你的钱包并批准交易，或直接调用 approve_trading。交易本身无需支付 Gas 费：交易所会在链上结算成交。

设置

变量	默认值	含义
`LUCYD_PRIVATE_KEY`	none	用于签署订单和交易的钱包密钥。未设置时，交易工具将不可用
`LUCYD_MAX_ORDER_USD`	`100`	以 USDC 计的最大买入订单金额
`LUCYD_READ_ONLY`	`false`	设为 `true` 时，会停用所有交易或发送交易的工具
`LUCYD_RPC_URL`	`https://ethereum-sepolia-rpc.publicnode.com`	Sepolia RPC 节点
`LUCYD_API_URL`	`https://api.testnet.lucyd.trade`	市场 API
`LUCYD_CLOB_URL`	`https://clob.testnet.lucyd.trade`	订单簿

安全

密钥不会离开你的设备。服务会在本地签名，并且只发送已签名的订单和交易。
为 Agent 使用单独的钱包，并且只在其中存放你愿意用于交易的资金。
服务会提示 Agent 在交易前征求你的同意，但这取决于 Agent。如果你只想查看数据，可以将 LUCYD_MAX_ORDER_USD 设为较低值，或将 LUCYD_READ_ONLY=true。

工作原理

服务在本地运行，并通过 stdio 与 Agent 通信。市场数据来自公开的 API。订单使用 EIP-712 签名，并通过 WebSocket 发送到订单簿（协议见 API 文档）。授权和赎回是在 Sepolia 上执行的普通交易。

合约	地址
Exchange	`0x6588c789c6b6df8f8b6b92e6433f813cc2d1d4d0`
ConditionalTokens（结果代币）	`0xB62eFc43C16b4E2Bf1aAAD33002368e55708538D`
USDC（6 位小数）	`0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238`
AutoRedeemer	`0x42Bf669f0A3DCc95510001Ddbc43D56FdE67268F`