# @0xmonaco/mcp-server 中文文档

规范地址：https://npmcn.com/package/%400xmonaco/mcp-server/

版本：1\.1\.9
npm 元数据更新时间：2026-11-06T20:42:14.889Z
中文译文更新时间：2026-11-06T20:43:55.042Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%400xmonaco/mcp-server
原文对照：https://npmcn.com/package/%400xmonaco/mcp-server/?lang=original
项目主页：https://docs.0xmonaco.com/sdk/typescript

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

- 包体积（解压后）：1.3 MB，3 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：7 个
- 首次发布：2025-08-28T02:00:43.053Z
- 最新版本发布：2026-11-06T20:42:14.689Z
- 近 30 天下载量：5985（2026-10-04 至 2026-11-02，npm 官方下载统计）
- 已发布版本数：180（近 12 个月 174 个）

## 中文简介

摩纳哥 SDK 的 MCP 服务器

## 安装

```sh
npm install @0xmonaco/mcp-server
```

也可以使用：`pnpm add @0xmonaco/mcp-server`、`yarn add @0xmonaco/mcp-server`、`bun add @0xmonaco/mcp-server`

## README

# @ 0xmonaco/ mcp- 服务器

摩纳哥SDK的MCP服务器——允许AI助手访问摩纳哥关于塞的协议.

在职 **只公开模式** 配置为零。 添加私人密钥以启用 鉴定工具——范围: [能力简介](https://npmcn.com/package/%400xmonaco/mcp-server/#readme-capability-profiles) 这样 提供密钥 **没有** 盲目解锁整个工具集.

## 配置

| 变量 | 需求 | 说明 |
| --- | --- | --- |
| `MONACO_PRIVATE_KEY` | 没有 | 钱包私钥( E)`0x...`——使认证工具能够使用 |
| `MONACO_CLIENT_ID` | 与 `MONACO_PRIVATE_KEY` | 摩纳哥申请客户端ID |
| `MONACO_NETWORK` | 与 `MONACO_PRIVATE_KEY` | 设定为 `mainnet`。 。 。 . **设置私人密钥时必须明确** ——服务器拒绝默认 `mainnet` 用于验证的会话。 默认为 `mainnet` 仅限公用模式. |
| `MONACO_CAPABILITY` | 没有 | `read` | `market-maker` | `full`。验证默认默认值 : `read`。见 [能力简介](https://npmcn.com/package/%400xmonaco/mcp-server/#readme-capability-profiles)。 。 。 . |
| `MONACO_TOOL_ALLOWLIST` | 没有 | 逗号相隔的工具名可以让出在配置图上方(说明每个工具的选入,例如一个单一的基金-移动工具). |
| `MONACO_TOOL_DENYLIST` | 没有 | 以逗号分隔的工具名称来禁用 。 赢得了配置和许可列表. |
| `MONACO_RPC_URL` | 没有 | Sei RPC URL( 每个网络的默认) |
| `MONACO_DELEGATED_OWNER_USER_ID` | 没有 | 代表委托方运行 **拥有者** 账户。 这个 `MONACO_PRIVATE_KEY` 钱包是代理;在启动时,它会像自己一样认证,然后通过一个所有者范围的会议,因此每个工具都呼吁所有者采取行动(代理钱包会保留会议参与者的政策执行;命令会携带所有者钱包)。 要求数 `MONACO_PRIVATE_KEY` + 键 `MONACO_CLIENT_ID`。见 [授权所有者模式](https://npmcn.com/package/%400xmonaco/mcp-server/#readme-delegated-owner-mode)。 。 。 . |

## 能力简介

`MONACO_CAPABILITY` 服务器注册工具的认证范围 。 一个工具 活动配置文件不允许使用(且未在 `MONACO_TOOL_ALLOWLIST`)为 **从未注册** - 这是一个授权控制,不是咨询工具 注释.

| 简介 | 启用工具 |
| --- | --- |
| `read` | 经认证的只读查询——概况,余额,订单,调度,收费等级,金库备抵. 无州变相. **认证时默认** 仅提供一把钥匙就无文字授权. |
| `market-maker` | `read` +命令放置/取消/替换. 选择让代理商做市场。 没有资金流动. |
| `full` | `market-maker` + 资金变动和特权变动(过失核准/存放/撤销, `transfer_rewards`) (中文(简体) ). 仅限选入. |

安排、取消、替换和关闭要求 `MONACO_CAPABILITY=market-maker` 或者说 更高——默认值 `read` profile 无法突变任何东西 。 资金调动和特权 需要更多工具 `full`; 允许它们使用 `MONACO_CAPABILITY=full`,或选择 使用单工具 `MONACO_TOOL_ALLOWLIST` (例如:. `MONACO_TOOL_ALLOWLIST=vault_withdraw`) (中文(简体) ). 赠款 `full` 只有当你打算代理 移动资金,特别是 `mainnet`。 。 。 .

### 授权所有者模式

设定 `MONACO_DELEGATED_OWNER_USER_ID` 代表委托的所有者账户行事,而不是 配置的钱包自己的账户。 钱包在里面 `MONACO_PRIVATE_KEY` 这是 **代理人**打开 : 启动它本身认证,然后采用所有者范围的授权会话 (单位:千美元)`loginAsDelegatedOwner`) (中文(简体) ). 随后的每一个工具呼叫——读取和交易——对所有人采取行动 账户,以代理钱包作为会话执行政策的行为者。 发出的命令 这样可以携带主人的钱包,而不是代理人的钱包,所以订单历史不会记录代理人. 拥有者必须用活动授权策略注册此代理钱包; 服务器 如果代理人没有被授权拥有所有权,则收养无效.

此失败关闭 : `MONACO_DELEGATED_OWNER_USER_ID` 需求 `MONACO_PRIVATE_KEY` 财务报告和审定财务报表 `MONACO_CLIENT_ID`,拒绝空白值,如果所有者收养失败,服务器不会 回到交易 作为代理自己的账户。 资金调动工具仍然需要 `full` 并且授权会议不能撤销所有者抵押。 原始授权会议 设定有意不作为工具被曝光——所有者收养是一种启动选项,而不是一种 自动代理行动.

### 网络

对于公共终点,设置 `MONACO_NETWORK` 改为 `mainnet`数字 :

| 网络 | API 網址 | 默认 RPC URL |
| --- | --- | --- |
| `mainnet` (默认) | `https://apimonaco.xyz` | `https://evm-rpc.sei-apis.com` |

## 安装

在您的 MCP 配置中添加以下内容 :

-   **光标** —— 说 `~/.cursor/mcp.json`
-   **风起浪起** —— 说 `~/.codeium/windsurf/mcp_config.json`
-   **克劳德桌面** —— 说 `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) (英语)

### 仅限公用模式( 不需要 vars )

市场数据、订货簿、交易和文件查询——不需要钱包.

```json
{
  "mcpServers": {
    "monaco": {
      "command": "npx",
      "args": ["-y", "@0xmonaco/mcp-server"]
    }
  }
}
```

### 认证模式

默认情况下已认证的只读工具 `read` 简介. `MONACO_NETWORK` 实值 **所需经费** 在此 —— 服务器不会默认已认证会话为 `mainnet`。 。 。 .

```json
{
  "mcpServers": {
    "monaco": {
      "command": "npx",
      "args": ["-y", "@0xmonaco/mcp-server"],
      "env": {
        "MONACO_NETWORK": "mainnet",
        "MONACO_PRIVATE_KEY": "0x...",
        "MONACO_CLIENT_ID": "your-client-id"
      }
    }
  }
}
```

贸易和资金流动停留 **关** 在这里。 添加 `"MONACO_CAPABILITY": "market-maker"` 以放置/取消/替换命令,或 `"MONACO_CAPABILITY": "full"` 同时启用 资金调动工具(, `transfer_rewards`) (中文(简体) ). 单一资金调动 工具可选择为 `"MONACO_TOOL_ALLOWLIST": "vault_withdraw"` 改为 `full`。 。 。 . RPC URL 每个网络自动默认, 但可用 `MONACO_RPC_URL`。 。 。 .

## 工具

公共工具不需要证书。 认证工具需要 `MONACO_PRIVATE_KEY`, (中文(简体) ), `MONACO_CLIENT_ID`,以及 `MONACO_NETWORK`,并被活跃的 [能力简介](https://npmcn.com/package/%400xmonaco/mcp-server/#readme-capability-profiles) ——配置栏显示最小值 配置每个工具需要.

### 搜索

| 工具 | 简介 | 说明 |
| --- | --- | --- |
| `search_docs` | 公开 | 查找摩纳哥的文件,以获取协议、SDK、贸易和发展指南. |

### 市场

| 工具 | 简介 | 说明 |
| --- | --- | --- |
| `get_trading_pairs` | 公开 | 列表交易对并带有可选过滤器(市场类型,基础/引号,活性状态). |
| `get_trading_pair_by_symbol` | 公开 | 按符号查找一对交易(例如:. `BTC/USDC`) (中文(简体) ). |
| `get_candlesticks` | 公开 | 获取 OHLCV 烛台数据进行交易. |
| `get_market_metadata` | 公开 | 获取勾选大小, 最小订单大小, 以及一对交易规则 . |
| `get_screener` | 公开 | 有市场统计数据(价格、数量、变化)的屏幕交易对等,按市场类型、类别和活跃状态过滤. |
| `get_market_stats` | 公开 | 使整个交易所的寿命累积量和交易量在所有市场上进行统计. |
| `get_trader_metrics` | 公开 | 获得公开的当前长/短账户计数,账户份额和比率,加上一个比值对的活跃交易商计数. 账户按各公开风险桶的净头寸分类。 小型组别被压制;活动计数包括清算时的系统用户ID和ADL填充. |
| `get_trade_flow` | 公开 | 获得UTC对齐的取用者买入/卖出引号标记桶和一对比值的累积容量三角洲,包括清算和ADL填充. |
| `list_liquidation_events` | 公开 | 列出每个填充的公众清算事件,包括使用每个事件被捕获标记的公共钱包和引号-资产名词. |
| `get_liquidation_metrics` | 公开 | 获得UTC对齐的长/短清算总数;事件计数代表坚持行并使用每行的事件时间标记. |

### 侵权市场数据

| 工具 | 简介 | 说明 |
| --- | --- | --- |
| `get_perp_market_config` | 公开 | 获得一个永久的市场配置(贷款限额、差额要求、供资参数). |
| `get_perp_market_summary` | 公开 | 获得永久市场实况汇总(马克/指数价格、供资率、开放利息、24小时统计). |
| `get_mark_price` | 公开 | 获得一个永久市场的当前标价. |
| `get_index_price` | 公开 | 获取永久市场的当前指数( oracle) 价格 . |
| `get_funding_state` | 公开 | 获得目前的供资率和下一个长期市场的供资时间. |
| `get_open_interest` | 公开 | 将当前片面长的利息(每份合同计算一次)作为永久市场. |
| `get_funding_history` | 公开 | 列出一个永久市场的历史供资率记录. |
| `get_all_funding_history` | 公开 | 列出所有永久市场的历史供资率记录. |

### 订单

| 工具 | 简介 | 说明 |
| --- | --- | --- |
| `get_orderbook` | 公开 | 获取当前带有出价的订单快照并询问 . |

### 行业

| 工具 | 简介 | 说明 |
| --- | --- | --- |
| `get_trades` | 公开 | 为一对交易获取历史交易. |

### 贸易

顺序为:`get_orders`, (中文(简体) ), `get_order`) 可在 `read`;下面的变异需要 `market-maker` 或更高级.

| 工具 | 简介 | 说明 |
| --- | --- | --- |
| `place_limit_order` | `market-maker` | 按照价格、数量和生效时间定出限额。 SDK如果省略,则提供一等能键. 保留明确的关键,以便在接受后15分钟内重试同一划界案。 没有原始密钥再次调用不是一码事;永远不要用新密钥重试模棱两可的失败. 如果原始密钥没有,请报告模糊性. |
| `place_market_order` | `market-maker` | 将市场秩序——立即执行在强制1000bps保护价格带内,因此可以部分地填充或拒绝. SDK如果省略,则提供一等能键. 保留明确的关键,以便在接受后15分钟内重试同一划界案。 没有原始密钥再次调用不是一码事;永远不要用新密钥重试模棱两可的失败. 如果原始密钥没有,请报告模糊性. |
| `replace_order` | `market-maker` | 修改现有订单的价格和/或数量。 非一能取出——一个模棱两可的失败(出站/网络出错/5xx,没有订单)无法从没有订单流工具的MCP内部解决;从不重试,转而报告模棱两可. |
| `cancel_order` | `market-maker` | 通过ID取消单项订单. |
| `batch_cancel_orders` | `market-maker` | 由ID取消多份订单(非原子-一条失败的腿不能阻止其他人). |
| `batch_cancel_all_orders` | `market-maker` | 取消所有打开的订单, 可选择过滤到交易对( 未过滤, 它取消您整个打开的订单) . |
| `cancel_all_after` | `market-maker` | 手臂,刷新或解除一个死人的开关,取消你的休息命令,除非在暂停前再次打电话(0个解除). |
| `batch_close_all_positions` | `market-maker` | 关闭所有开放的永久位置, 仅限市场订单( 最佳效果、 可选对接和侧式过滤器) . |
| `get_orders` | `read` | 以可选过滤器列出您的命令 . |
| `get_order` | `read` | 以身份证获取特定命令的细节 . |

### 职位

立场如下: `read`· ; `close_position` 需求 `market-maker`,而差值增加/减少移动抵押品并需要 `full`。 。 。 .

| 工具 | 简介 | 说明 |
| --- | --- | --- |
| `get_positions` | `read` | 以可选过滤器( 边距账户、 交易对、 状态) 列出您的永久位置 . |
| `get_position` | `read` | 用身份证明获取特定永久位置的细节 . |
| `get_position_risk` | `read` | 获得长期状态的清算价格、差值比率和风险衡量标准. |
| `get_position_history` | `read` | 列出具有可选过滤器的历史(封闭/减少)永久位置记录. |
| `get_position_pnl_history` | `read` | 获取 PnL 历史时间序列 在一个间隔期间永久位置 . |
| `close_position` | `market-maker` | 关闭永久位置与市场,限制, 或国际奥委会减少秩序. |

### 组合

| 工具 | 简介 | 说明 |
| --- | --- | --- |
| `get_portfolio_summary` | `read` | 获取您权威的组合摘要( 权益, PnL, 曝光) . |
| `get_portfolio_performance` | `read` | 得到你的组合业绩 时间序列一段时间. |
| `get_portfolio_realized_pnl` | `read` | 得到你意识到的PNL分解一段时间. |
| `get_portfolio_assets` | `read` | 得到你的每个资产 组合分配和余额 在一段时间. |
| `get_portfolio_margin` | `read` | 获取您的投资组合比值概览( 抵押、 维护比值、 健康) . |

### 边距账户

阅读和风险模拟可在 `read`; 抵押转移转移资金和要求 `full` profile(或明确的许可列表条目).

| 工具 | 简介 | 说明 |
| --- | --- | --- |
| `get_margin_accounts` | `read` | 以可选过滤器( 状态, 交易对) 列出您的边距账户 . |
| `get_parent_margin_account_summary` | `read` | 获取父母(交叉)差值账户汇总. |
| `get_available_collateral` | `read` | 获得(未锁定)抵押品,以便分配到差额账户或风险桶. |
| `get_parent_margin_account_movements` | `read` | 列出您父母( 交叉) 边际账户的抵押移动 . |
| `simulate_parent_margin_order_risk` | `read` | 预览针对您母( 交叉) 边距账户( 仅读模拟) 的未来订单的风险影响 . |
| `simulate_risk_bucket_order_risk` | `read` | 预览新建或已存在的风险桶(只读模拟)的预期订单的风险影响. |
| `transfer_collateral_to_parent_margin_account` | `full` | 将抵押品从现场移动到您的父( 交叉) 边际账户 . |
| `transfer_collateral_from_parent_margin_account` | `full` | 将担保品从您母( 交叉) 边际账户中移回当场 . |
| `transfer_collateral_to_risk_bucket` | `full` | 将抵押品放入孤立或交叉的风险桶. |
| `transfer_collateral_to_sub_account` | `full` | 将默认( 父母) 边际账户中的抵押品移动到您的边际子账户中 . |
| `transfer_collateral_from_sub_account` | `full` | 将抵押品从您的边际子账户中的某个账户移回您的默认( 父母) 边际账户 . |

### 简介

| 工具 | 简介 | 说明 |
| --- | --- | --- |
| `get_profile` | `read` | 获取您的核心配置文件( 地址、 用户名、 账户类型、 退出状态) . |
| `get_balances` | `read` | 列出带有 pagination 的符号余额 . |
| `get_balance_by_asset` | `read` | 为特定资产取得平衡. |
| `get_movements` | `read` | 用可选过滤器获取交易和移动历史 . |
| `get_user_trades` | `read` | 列出您自己的交易中包含可选过滤器和光标页. |
| `get_funding_payments` | `read` | 以可选过滤器( 交易对数、 位置、 差值账户) 列出您的永久供资支付 . |

### 收费

| 工具 | 简介 | 说明 |
| --- | --- | --- |
| `get_fee_schedule` | 公开 | 获得交易对等的收费等级表:量阈值和每个等级的制作人/塔克人bps(不需要证书). |
| `simulate_fees` | `read` | 在下订单前模拟订单收费. |
| `get_my_fee_tier` | `read` | 获取您的当前收费等级, 您的收费标准为何适用(`rateSource`),您有效的制造者和摄取者对一对,滚动14天的卷,和对对的收费表. |

### 默认

资金调动工具要求 `full` 概况(或明确的许可名单条目); 备抵和待撤销的备忘,可在 `read`。 。 。 .

| 工具 | 简介 | 说明 |
| --- | --- | --- |
| `vault_approve` | `full` | 批准金库合同 花一个纪念品. |
| `vault_deposit` | `full` | 存入金库的符号( 可选) `target`数字 : `spot` 默认,或 `margin` (a) 进入担保物的路线. |
| `vault_withdraw` | `full` | 从金库里取出信物. |
| `vault_get_allowance` | `read` | 请检查date=中的日期值 (帮助). |
| `vault_needs_approval` | `read` | 检查存款前是否需要批准交易. |
| `get_pending_withdrawals` | `read` | 列出你仍在等待链上确认的提款. |

### 福赛特

只有测试网——水龙头工具从未在 `mainnet`。 。 。 .

| 工具 | 简介 | 说明 |
| --- | --- | --- |
| `request_faucet` | `market-maker` (非主网) | 为所有交易配对请求测试令牌. |
| `get_faucet_info` | `read` (非主网) | 检查剩下的水龙头配额, 下一次要求的时间, 和最近的薄荷历史. |

### 交易码和奖励

| 工具 | 简介 | 说明 |
| --- | --- | --- |
| `get_trader_code_info` | 公开 | 查找交易码的细节( 不需要证书) . |
| `check_trader_code_availability` | 公开 | 公共咨询检查是否有自定义的TraderCode手柄(不需要证书). |
| `get_my_trader_code` | `read` | 获取自己的交易商代码. |
| `set_trader_code` | `market-maker` | 声称或编辑您的自定义( 优点) TraderCode 手柄 . |
| `clear_trader_code` | `market-maker` | 清除自定义的 TraderCode 手柄, 恢复到钱包生成的默认值 . |
| `get_rewards_balance` | `read` | 找回你的交易商代码 奖牌上的平衡. |
| `transfer_rewards` | `full` | 将你赚到的TraderCodes奖励从奖励桶中移入你自己的可交易余额(只有铅). |

### 市场脉冲

| 工具 | 简介 | 说明 |
| --- | --- | --- |
| `get_pulse` | 公开 | 获得最新市场推力新闻资讯:AI-合成,每资产头条有情绪标签. |

_该清单来自工具清单。 不要用手编辑 – 编辑 `src/manifest.ts` 运行 `bun run mcp-docs:gen`。 。 。 ._

## 常见问题

### @0xmonaco/mcp-server 是什么？

摩纳哥 SDK 的 MCP 服务器

### 如何安装 @0xmonaco/mcp-server？

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

### @0xmonaco/mcp-server 支持 TypeScript 吗？

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

### @0xmonaco/mcp-server 支持 ESM 还是 CommonJS？

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

### @0xmonaco/mcp-server 需要什么版本的 Node\.js？

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

### @0xmonaco/mcp-server 可以商用吗？

@0xmonaco/mcp-server 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @0xmonaco/mcp-server 的下载量有多少？

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

### @0xmonaco/mcp-server 还在维护吗？

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