@0xmonaco/mcp-server

中文文档
1.1.9发布于 2026/11/07ES Module近 30 天下载 5985

摩纳哥 SDK 的 MCP 服务器

中文使用文档
文档目录23 节
  1. 配置
  2. 能力简介
  3. 授权所有者模式
  4. 网络
  5. 安装
  6. 仅限公用模式( 不需要 vars )
  7. 认证模式
  8. 工具
  9. 搜索
  10. 市场
  11. 侵权市场数据
  12. 订单
  13. 行业
  14. 贸易
  15. 职位
  16. 组合
  17. 边距账户
  18. 简介
  19. 收费
  20. 默认
  21. 福赛特
  22. 交易码和奖励
  23. 市场脉冲

@ 0xmonaco/ mcp- 服务器

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

在职 只公开模式 配置为零。 添加私人密钥以启用 鉴定工具——范围: 能力简介 这样 提供密钥 没有 盲目解锁整个工具集.

配置

变量需求说明
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。见 能力简介。 。 。 .
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。见 授权所有者模式。 。 。 .

能力简介

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

简介启用工具
read经认证的只读查询——概况,余额,订单,调度,收费等级,金库备抵. 无州变相. 认证时默认 仅提供一把钥匙就无文字授权.
market-makerread +命令放置/取消/替换. 选择让代理商做市场。 没有资金流动.
fullmarket-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.xyzhttps://evm-rpc.sei-apis.com

安装

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

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

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

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

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

认证模式

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

{
  "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,并被活跃的 能力简介 ——配置栏显示最小值 配置每个工具需要.

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

职位

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

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

组合

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

边距账户

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

工具简介说明
get_margin_accountsread以可选过滤器( 状态, 交易对) 列出您的边距账户 .
get_parent_margin_account_summaryread获取父母(交叉)差值账户汇总.
get_available_collateralread获得(未锁定)抵押品,以便分配到差额账户或风险桶.
get_parent_margin_account_movementsread列出您父母( 交叉) 边际账户的抵押移动 .
simulate_parent_margin_order_riskread预览针对您母( 交叉) 边距账户( 仅读模拟) 的未来订单的风险影响 .
simulate_risk_bucket_order_riskread预览新建或已存在的风险桶(只读模拟)的预期订单的风险影响.
transfer_collateral_to_parent_margin_accountfull将抵押品从现场移动到您的父( 交叉) 边际账户 .
transfer_collateral_from_parent_margin_accountfull将担保品从您母( 交叉) 边际账户中移回当场 .
transfer_collateral_to_risk_bucketfull将抵押品放入孤立或交叉的风险桶.
transfer_collateral_to_sub_accountfull将默认( 父母) 边际账户中的抵押品移动到您的边际子账户中 .
transfer_collateral_from_sub_accountfull将抵押品从您的边际子账户中的某个账户移回您的默认( 父母) 边际账户 .

简介

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

收费

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

默认

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

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

福赛特

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

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

交易码和奖励

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

市场脉冲

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

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

版本与发布记录

@0xmonaco/mcp-server 共发布 180 个版本,首次发布于 2025/08/28;过去 12 个月发布了 174 个版本。

版本发布日期距今
1.1.9latest2026/11/07今天
1.1.82026/11/061 天前
1.1.72026/11/052 天前
1.1.62026/11/053 天前
1.1.5-prerelease.de852e2prerelease-1.1.62026/11/043 天前
1.1.5-develop.129b2c6develop2026/11/044 天前

其他发布通道:prerelease-1.0.40 → 1.0.39-prerelease.19d492d,develop → 1.1.5-develop.129b2c6,prerelease-1.1.6 → 1.1.5-prerelease.de852e2。

关于 @0xmonaco/mcp-server 的常见问题

@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 和提交记录判断。