# @esseyonsui/sui-mcp 中文文档

规范地址：https://npmcn.com/package/%40esseyonsui/sui-mcp/

版本：0\.1\.16
npm 元数据更新时间：2026-11-10T17:35:26.410Z
中文译文更新时间：2026-11-13T23:05:33.642Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40esseyonsui/sui-mcp
原文对照：https://npmcn.com/package/%40esseyonsui/sui-mcp/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：243 kB，35 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：2 个
- 首次发布：2026-10-31T22:35:11.998Z
- 最新版本发布：2026-11-10T17:35:26.189Z
- 近 30 天下载量：3571（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 18 个）

## 中文简介

一个模式上下文协议服务器 `@esseyonsui/sui-sdk` 对一个用自己机器运行的特工来说 斯特迪奥运输公司. 测试网和当地网只限. `0.1.15` 是这个软件包的版本(22+号)。 每一个都留着 `loanMarkets` 条目 `oraclePkg`时

## 安装

```sh
npm install @esseyonsui/sui-mcp
```

也可以使用：`pnpm add @esseyonsui/sui-mcp`、`yarn add @esseyonsui/sui-mcp`、`bun add @esseyonsui/sui-mcp`

## README

# @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/sui-sdk@0.1.11` (单位:千美元)`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/sui-sdk@0.1.11` 匹配这棵树。 没有 `@esseyonsui/sui-mcp@0.1.14` 发表于 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`。 。 。 .

## 常见问题

### @esseyonsui/sui-mcp 是什么？

一个模式上下文协议服务器 @esseyonsui/sui-sdk 对一个用自己机器运行的特工来说 斯特迪奥运输公司\. 测试网和当地网只限\. 0\.1\.15 是这个软件包的版本\(22\+号\)。 每一个都留着 loanMarkets 条目 oraclePkg时

### 如何安装 @esseyonsui/sui-mcp？

在项目目录运行 npm install @esseyonsui/sui-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 essey-sui-mcp、essey-sui-init，可以用 npx essey-sui-mcp 直接运行。

### @esseyonsui/sui-mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/esseyonsui\_\_sui-mcp 是否存在。

### @esseyonsui/sui-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @esseyonsui/sui-mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @esseyonsui/sui-mcp 可以商用吗？

@esseyonsui/sui-mcp 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @esseyonsui/sui-mcp 的下载量有多少？

根据 npm 官方下载统计，@esseyonsui/sui-mcp 在 2026/10/14 – 2026/11/12 这 30 天内被下载 3,571 次，日均约 119 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @esseyonsui/sui-mcp 还在维护吗？

最新版本 0\.1\.16 发布于 2026/11/11（3 天前）；至今共发布 18 个版本，其中过去 12 个月发布了 18 个；首次发布于 2026/11/01。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。