概述
lighter-mcp 是一个面向 Lighter 的 MCP（模型上下文协议）服务器。Lighter 是运行在以太坊上的零手续费 zk-rollup 永续合约去中心化交易所。通过该服务器，任何支持 MCP 的客户端都可以原生交易 Lighter 永续合约：下单、管理仓位、设置链上止损/止盈、查询行情与账户状态。
主要能力
- 提供 17 个交易工具，另含 get_status、get_signup_info、how_to_approve_integrator 三个诊断工具。
- 三级凭证模式：无需凭证即可安装试用，按需逐级开放更多权限。
- 原生链上止损/止盈：客户端重启后依然有效。
- 以 USDC 名义金额市价下单，便于简单定量；限价单以基础资产数量下单，便于精确控制。
- 多市场支持：交易对从订单簿 API 自动发现。
- 子账户优先设计：API 密钥为子账户签名，主钱包保持冷存储。
- 服务器端安全上限：最大交易规模、滑点限制、交易对白名单。
- 按市场进行价格/数量编码，正确处理所有已上架永续合约（如 BTC 1 位小数、NEAR 5 位小数等）。
使用方式
服务器在启动时根据设置的环境变量选择三种模式之一，更高权限模式必须显式选择加入。在 TRADE 模式下，可随时通过 LIGHTER_READ_ONLY=true 降级为只读，此时下单工具将不再注册。
配置文件路径：macOS 为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 为 %APPDATA%\Claude\claude_desktop_config.json。
最小配置（PUBLIC 模式，无需 Lighter 账户）；完整配置（TRADE 模式，需要子账户 API 密钥）。重启 Claude Desktop 后即可尝试：“List my Lighter markets”（PUBLIC 模式即可用）或“What's my balance?”（需要 READ 及以上权限）。
Cursor 或其他 MCP 客户端使用相同的命令与参数，具体格式请查阅对应客户端的 MCP 服务器配置说明。
工具分层
始终可用（第一级 — PUBLIC）：get_status（当前模式、安全策略、集成器配置，不含机密）；get_signup_info（Lighter 注册链接与推荐码，新用户享 5% 奖励）；how_to_approve_integrator（选择加入/退出说明）；list_markets、get_market(symbol)（市场发现）；get_candles、get_ticker、get_orderbook、get_funding_rate（行情数据）。
配置 LIGHTER_ACCOUNT_INDEX 后（第二级 — READ）：get_balance（抵押品/占用保证金/可用/资产价值）；get_positions、get_position(symbol)（持仓查询）。
配置 LIGHTER_PRIVATE_KEY 后（第三级 — TRADE）：set_leverage(symbol, leverage, cross)；place_market_order(symbol, side, quote_amount_usd, reduce_only)；place_limit_order(symbol, side, base_amount, price)；place_stop_loss(symbol, side, base_amount, trigger_price)（链上、仅减仓）；place_take_profit(symbol, side, base_amount, trigger_price)（链上、仅减仓）；close_position(symbol)；cancel_order(order_id, symbol)；cancel_all_orders。
费用与选择加入
该 MCP 免费且开源，可自由安装、运行和交易，无需向任何人付费。若觉得有用，可选择加入一笔小额费用以支持项目持续维护——只需一次链上交易，无周期性动作。费率为自有交易的 1 bp 挂单（0.01%）/ 2 bps 吃单（0.02%）。费用通过 Lighter 的无许可合作伙伴集成商计划路由至维护者账户 725426，在你签署一次链上 ApproveIntegrator 之前不会产生任何费用。这完全是可选的：不批准也能安装与交易。
关于 Lighter 标准费用的如实披露：Lighter 标准账户（零售默认）目前为 0 挂单/0 吃单手续费，批准集成器意味着支付本不存在的 1-2 bps；Lighter 高级账户费率为 2/20 bps，批准集成器后变为 1/2 bps，反而更省钱。对标准账户而言批准是一份小额“感谢”贡献，对高级账户则是明确的双赢。
选择加入（一次性，约 60 秒，推荐浏览器流程）：会打开一个本地网页，连接 Metamask/Rabby，点击 Approve，在钱包中签署 EIP-191 消息。L1 钱包密钥始终不会离开钱包界面，只有 EIP-191 个人签名会返回本地脚本。
撤销方式：将批准设为零费用；或更简单地通过客户端禁用而不做链上变更（设置后集成器参数根本不会附加到订单上，零归属、零潜在费用流）。批准默认 90 天后过期，仅在想继续贡献时才需重新批准，不存在静默锁定。
信任与安全
该服务器使用你放入 LIGHTER_PRIVATE_KEY 的密钥签名交易，应将其视为整个配置中最敏感的值。可信任或审计的原因：完全开源，全部代码位于 github.com/0xDegenMo/lighter-mcp，总共约 800 行 Python，30 分钟内可读完；子账户隔离，API 密钥仅为一个 Lighter 子账户签名，无法提取资金，无法触碰主钱包；三级分离，需要凭证的工具仅在有凭证时注册，PUBLIC 模式服务器即使被要求也无法下单；集成器费用由 Lighter 强制执行，即使维护者发布试图抽成的恶意代码，Lighter 协议也要求你的链上 ApproveIntegrator 才能产生费用，没有你的签名，集成器参数是无效的；撤销简单，lighter-mcp-approve --revoke 或 LIGHTER_NO_INTEGRATOR=true 环境变量，几秒完成；批准默认 90 天过期，需重新确认意图，绝不静默锁定。
安全建议：使用 Lighter 子账户而非主钱包，在 Lighter 界面创建子账户，只存入愿意承担风险的资金，为该子账户生成 apiKeyIndex >= 2 的 API 密钥，该密钥无法提现，只能为该子账户签署交易；切勿将主钱包助记词或主签名密钥放入环境变量，该 MCP 并不需要；将 LIGHTER_PRIVATE_KEY 视为机密，不要提交 .env，不要粘贴到共享聊天中。
服务器端上限（在订单离开进程前强制执行）：LIGHTER_MAX_QUOTE_USD（默认 100）为开仓交易规模上限（USDC），reduce_only=True 的订单不受该上限限制，因此平仓/减仓始终可用；LIGHTER_MAX_SLIPPAGE（默认 0.005 即 0.5%）适用于市价单；LIGHTER_ALLOWED_SYMBOLS（默认所有市场）为逗号分隔的白名单，若设置，其他交易对的服务端交易会被拒绝；LIGHTER_API_KEY_INDEX < 2 会在启动时记录警告，索引 0/1 通常保留给主账户。
操作说明
日志（stderr）包含当前模式与集成器配置，但绝不包含私钥（仅在极少数密钥出现在错误路径时显示首尾几个字符）。cancel_all_orders 会取消子账户中所有市场的订单，请谨慎使用。全仓保证金：子账户中所有仓位共享抵押品，一笔糟糕的交易可能耗尽整个子账户，但不会影响其他部分。
分叉与自定义集成器
若分叉此项目，可将费用路由至自己的账户，随后每次安装都需要为自己的账户单独签署 ApproveIntegrator 后费用才会流动。
