@sesyonsui/sui-mcp (英语)
一个模式上下文协议服务器 @esseyonsui/sui-sdk 对一个用自己机器运行的特工来说 斯特迪奥
运输。 测试网和当地网只限. 0.1.15 是这个软件包的版本(22+号)。 每一个都留着 loanMarkets 条目 oraclePkg, (中文(简体) ), feed 财务报告和审定财务报表 reader 何时 ESSEY_PRIVATE 为已保存 GET /v1/private/config,它接受数字 rateBps 外加赤平长六分 sealed 在承诺工具。 它安装了两个命令: essey-sui-mcp (服务器)和 essey-sui-init (将代理人与账户联系起来,其所有人批准一次). ESSEY_DEPLOYMENT 财务报告和审定财务报表 ESSEY_PRIVATE 接受 GET /v1/config 财务报告和审定财务报表 GET /v1/private/config 保存为文件. ESSEY_SHIELDED_STATE 是模式600被屏蔽的种子文件. essey_upkeep 给SDK打电话 upkeep,该大小的池在活曲线上还原. essey_loan_repay_v2 报还一出公币. 中继器没有 repay_v2 有点 安装 underscore 覆盖于
site/content/sdk/install.md它取决于
@esseyonsui/[email protected] (单位:千美元)site/content/sdk/install.md(b) 其国家 buildPoolBidV2 编号 : buildOfferV2 编曲完成
游泳池花那个 essey_private_sale_pool_bid_v2 财务报告和审定财务报表 essey_private_offer_v2 和谁的 bidV2Body 编号 :
loanOfferV2Body 构建这些工具的交易对应的中继器机构。 一个切口 ESSEY_DEPLOYMENT 套装 oraclePkg 到 Pyth 软件包 essey_borrow 电话
pyth_oracle::read 在这里. 0.1.2 添加 essey_private_* 工具时 ESSEY_PRIVATE 已经设定.
两种工具,按键分割
essey_*工具用代理商自己的密钥签名,在链上设定的限度内。 链子的拒绝来了 返回为交易摘要和中止的移动名称的错误结果.essey_owner_*工具从不签名。 他们回来了{ kind: "unsigned", sender, txBytes, kindBytes, agentSigned: false }用于所有者在自己的钱包或密码设备中签名。 车主地址和车主Caps都来自该链条 键分离检查,而不是配置.
读取: essey_status, (中文(简体) ), essey_offers, (中文(简体) ), essey_loans, (中文(简体) ), essey_quote, (中文(简体) ), essey_rooms, (中文(简体) ), essey_warnings。 。 。 .
代理人(签名): essey_post_offer, (中文(简体) ), essey_cancel_offer, (中文(简体) ), essey_borrow, (中文(简体) ), essey_repay, (中文(简体) ), essey_refinance, (中文(简体) ),
essey_add_collateral, (中文(简体) ), essey_claim, (中文(简体) ), essey_upkeep。 。 。 .
借款人从自己的钱包中打开并结清一个密封的房间;没有工具让代理密钥借出一个房间,以及
EsseyAgent.execute,每个代理工具通过,拒绝打开房间或与 NOT_AGENT_CALL。 。 。 .
所有人(未签字): essey_owner_setup, (中文(简体) ), essey_owner_lender_rules, (中文(简体) ), essey_owner_deposit, (中文(简体) ), essey_owner_renew, (中文(简体) ),
essey_owner_revoke, (中文(简体) ), essey_owner_withdraw, (中文(简体) ), essey_owner_collect_default, (中文(简体) ), essey_owner_loan。 。 。 .
金额是硬币最小单位的整数字符串(USDC: 1 USDC = "1000000"; SUI: 1 SUI = (中文(简体) )
"1000000000") (中文(简体) ).
配置(环境)
| 变量 | |
|---|---|
ESSEY_NETWORK | localnet 或者说 testnet (必须) |
ESSEY_DEPLOYMENT | jSON 部署路径( 需要) |
ESSEY_AGENT_KEY_FILE | 代理密钥文件, 模式 600( 需要; 唯一的密钥设置) |
ESSEY_TREASURY, (中文(简体) ), ESSEY_AGENT_CAP | 代理人的金库和上限(合并,或设置前没有) |
ESSEY_CASH_TREASURY, (中文(简体) ), ESSEY_CASH_CAP | 借款人贷款货币国库和上限(共同) |
ESSEY_GAS | coins (违约)或 address-balance |
ESSEY_BORROW_ALLOWANCE | a. 借出货币最小单位的借款人借款津贴; essey_owner_deposit 把它纳入规则 它构建和不采取允许输入 |
ESSEY_REPAY_LEAD_MS | 维持在贷款到期前的这么长一段时间(违约和下限:1小时)偿还贷款 |
ESSEY_AUTO_TOP_UP | on 或者说 off (默认):保持将SUI从SUI金库移动到安全线附近的贷款中 |
ESSEY_AUTO_CLAIM | on (违约)或 off: 维持生计带回家 留下的封闭贷款 |
ESSEY_RPC_URL, (中文(简体) ), ESSEY_GRAPHQL_URL | 可选的覆盖, 仍在网络中检查 |
ESSEY_PRIVATE | 路径到私有流 ids 文件(仅包含 loanMarkets) (中文(简体) ). 准备吧 deployments/essey-private.testnet.json ,或来自 testnetPrivateMcp(),服务器添加 essey_private_*。 。 。 . loanMarkets 携带三个活市场, USDC (单位:千美元)Market<SUI, USDC>, (中文(简体) ), USDSUI (单位:千美元)Market<SUI, USDSUI>和 SUI (单位:千美元)Market<USDSUI, SUI>编号 : GET /v1/private/config 返回在 loanMarkets.<coin>.id |
任何其他 ESSEY_* 变量停止服务器,包含 OWNER 或任何持有私有值的值
键src/config.ts) (中文(简体) ).
私人流量和主机中继器
与 ESSEY_PRIVATE 设定, essey_private_settle 财务报告和审定财务报表 essey_private_repay 返回未签名的字节( e)agentSigned: false) (中文(简体) ). 不要用代理密钥签名, 不要 POST txBytes 到中继器。 托管服务重建来自 kind=settle_relayed 财务报告和审定财务报表 kind=repay 打开 POST /relay/<coin>。实地绘图、占位体和拒绝原始 txBytes 包含 site/content/sdk/mcp/private-tools.md没有 repay_relayed 条目 : private_room::repay 是中继还款.
当拯救的时候 /v1/private/config 携带 saleRoomV2 财务报告和审定财务报表 privateLoanV2 (Sui测试网自2026-11-08起确实如此),5
更多工具绑定 : essey_private_offer_commit_v2, (中文(简体) ), essey_private_offer_v2, (中文(简体) ), essey_private_sale_pool_bid_v2, (中文(简体) ),
essey_private_action_binding_v2 财务报告和审定财务报表 essey_private_settle_v2他们搭建了密封房间的电话
(单位:千美元)sale_room_v2, (中文(简体) ), private_room_v2:竞价或报价是波塞冬承诺,加上只有东道主才能使用的密封密码
关闭后打开,以及 settle编号 :finish 带一个Groth16 的 选择证明, 永远不要丢失的值。 中继器
类型是 bid_v2, (中文(简体) ), loan_offer_v2 财务报告和审定财务报表 settle_relayed_v2;其字段从工具的参数中绘制
site/content/sdk/mcp/private-tools.md,SDK则会建造尸体(bidV2Body, (中文(简体) ), loanOfferV2Body, (中文(简体) ),
settleRelayedV2Body,或 buildPoolBidV2 编号 : buildOfferV2 与证明.
拒绝逃跑
启动服务器连接,加载密钥,并运行SDK的密钥分离检查. 如果经纪人的钥匙有自己的
所有者Cap(或所有者Cap是共享的、被冻结的或无法读取的)它写下不服务而 stderr和出站1的理由
(单位:千美元)src/main.ts) (中文(简体) ). 每个签名工具在签名前都会再次运行检查.
维护: 由你自己的经纪人管理的主机得到什么
一次通过( O)essey_upkeep,或 upkeep() 在SDK中)做宿主跑跑者对其特工的所为,使用相同的
规则:借款人在到期还款前偿还要约贷款,每笔贷款按期偿还(一小时)
在现金封顶结束之前,或所有者在链上偿还,如果更早的话),但只有一次其现金库和现金封顶
支付连锁店可以提取的; 带回剩余的已清算、注销或违约的贷款; 并充上贷款
靠近安全线 从SUI金库。 贷款人过去未偿还的贷款 加上恩惠
owner-action 与所有者未签名的步数 claim_default 字节:代理无法签名 。 每一个传球都以
警告时间: essey_warnings。 。 。 . dryRun: true 报告未经签署.
要运行为循环而非调用工具: essey-sui-mcp upkeep [--every <seconds>] [--passes <n>] [--dry-run]
(每60 s直到默认SIGINT) 具有相同的环境. 它印出每步一列JSON一行和每通一行.
和克劳德
examples/claude.ts 打印 claude mcp add 线条和 claude_desktop_config.json 本地网络的块
借出者,然后像克洛德那样用官方的MCP客户端驱动服务器.
0.1.15 国家
0.1.15是这个包的版本. 它可以维持依赖 @esseyonsui/sui-sdk 编号为0.1.11。 SDK没有重新发布: npm 的 @esseyonsui/[email protected] 匹配这棵树。 没有 @esseyonsui/[email protected] 发表于 Githead 42d8b6f5,在 PR #54 和 PR #56 之前. 0.1.15是密码加上这些修正:钱包出价从房间出价表读取,一V1屏蔽出价带有开销入房证书,一退一出金额为0的退一出被拒绝(ZERO_WITHDRAW) (中文(简体) ).
0.1.16 (中文(简体) )
还没有在npm。 这取决于 @esseyonsui/sui-sdk 0.1.12, 还没有在npm上. essey_borrow, (中文(简体) ), essey_repay 财务报告和审定财务报表 essey_refinance 返回时 loanId, (中文(简体) ), essey_loans 带 includeClosed,以及 essey_shielded_recover 返回纸币的硬币(取自 SDK 0.1.12 / MCP 0.1.16).
依赖关系
超过SDK的运行时间没有 服务器会说它所需要的MCP的 stdio子集(src/protocol.ts: 官员
@modelcontextprotocol/sdk 1.3.2. 解决95个包(表达、呼声、jose、cors等),将在内部运行
键。 官方客户端只安装在 test-client/ (精确地说, 自己的锁文件,
npm ci --ignore-scripts;95个软件包中没有一个有安装脚本)来证明互通性:
npm run test:interop。 。 。 .