How do I use minimax-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@minimax-mcp What's waiting on me in MiniMax right now?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

minimax-mcp

by Luckycat133

Overview Schema Source Related Servers Discussions Admin

JavaScript

Local

minimax-mcp

minimax-mcp 是专为 MiniMax Code 桌面客户端（macOS）打造的本地优先 stdio MCP (Model Context Protocol) 服务器与 Agent 技能包。

它让任何接入 MCP 的 AI Agent（如 Claude Desktop、Cursor、Codex、Antigravity 等）能够无缝感知、监控和操控本机 MiniMax Code 的全部会话、后台任务、问卷决策与 Bot 团队。

┌────────────────────────────────────────────────────────┐
│                   Agent Host / Client                  │
│       (Claude Desktop, Cursor, Antigravity, etc.)      │
└───────────────────────────┬────────────────────────────┘
                            │ stdio (JSON-RPC 2.0)
┌───────────────────────────▼────────────────────────────┐
│                       minimax-mcp                      │
│     (27 Tools · 3 Risk Levels · Proactive Watcher)     │
└───────────┬────────────────────────────────┬───────────┘
            │                                │
      [Control Plane]                  [Data Plane]
            │                                │
 ┌──────────┴──────────┐            ┌────────┴──────────┐
 │ Chrome DevTools     │            │ Local SQLite DB   │
 │ Protocol (CDP)      │            │ Runtime State     │
 │ • DOM 级极速驱动    │            │ • 会话/消息历史   │
 │ • 0 系统权限要求    │            │ • 实时任务状态    │
 │ • 无视窗口遮挡/最小化│           │ • 待答问卷/审批   │
 └──────────┬──────────┘            └───────────────────┘
            │ Fallback
 ┌──────────┴──────────┐
 │ CoreGraphics / OCR  │
 │ • Vision 屏幕识别   │
 │ • 系统事件模拟      │
 └─────────────────────┘

🌟 核心特性

双通道高性能控制：
- 控制面（Write）：优先直连 CDP (Chrome DevTools Protocol) 端口，0 系统辅助权限、0 录屏权限依赖、无视窗口遮挡与最小化，微秒级操作 DOM 与 TipTap 富文本编辑器；非 CDP 环境下自动平滑降级至 CoreGraphics + macOS Vision OCR。
- 观察面（Read）：直读本机 SQLite 运行时状态，毫秒级感知任务完成、异常报错与会话流式变更，绝不污染客户端状态。
态势快照与注意力队列 (minimax_brief)：
- 按 等你决定 > 报错 > 卡住 > 运行中 > 刚完成 动态聚合注意力队列，沉睡的百余个历史会话自动折叠，节省 90% 提示词 Token。
- 每条条目自带结构化动作建议（suggestedCall），让纯文本或轻量级 Agent 零思考直接反射调用。
主动巡检与低风险自愈 (minimax_watch)：
- 自动跟踪状态变化并进入事件队列（minimax_events）。
- 内置纯函数风险策略引擎（四道安全闸门），支持自动催促卡住会话、低风险选项自动作答，高风险操作绝对保留给人。
MiniMax Bot 团队集成与智能断点续传：
- 支持通过 minimax_bot_message 直连 MiniMax 专家/Bot 团队（群聊分发、单聊调度与轮次管理）。
- 内置 minimax_auto_resume：自动识别因额度耗尽（2056）停下的长任务，在额度恢复后自动恢复（原生会话点击 ▶ 播放键原生继续，Bot 对话推进轮次）。

Related MCP server: mcp-macos

🛠️ 工具总览（27 个精细意图工具）

1. 观察与态势感知（只读，零副作用）

工具名	说明
`minimax_brief`	态势快照：按优先级聚合待办会话与建议动作，节省 Token 首选
`minimax_status`	查看本地数据库路径、会话数、消息总数及活动状态
`minimax_list_sessions`	列出最近会话列表，返回会话 ID 及序号
`minimax_read_session`	读取指定会话的历史消息（支持会话 ID `mvs_*` 或列表序号）
`minimax_tail_sessions`	快速采样最近 N 个会话末尾消息，适合多会话并发巡检
`minimax_search`	跨会话全文检索标题与消息内容，返回高亮聚焦上下文
`minimax_pending`	查询当前等待人工确认或答复的问卷与审批卡片
`minimax_tasks`	查询后台任务执行状态（running / succeeded / failed / canceled）
`minimax_draft_answer`	为待答问卷生成草稿回答建议（只读无副作用）
`minimax_windows`	获取 MiniMax 窗口在屏位置、尺寸及遮挡状态
`minimax_events`	读取巡检事件队列（finished / error / question / stalled）
`minimax_find_text`	定位界面中的文本元素（优先 CDP DOM，自动回退 Vision OCR）

2. 界面控制与输入（带安全守卫）

工具名	说明
`minimax_send_message`	往输入框注入文本并可选回车发送（带活跃防误触守卫）
`minimax_get_result`	等待指定会话当前轮次结束并收回复
`minimax_stop_generation`	终止当前正在生成或运行中的会话任务
`minimax_answer_question`	提交问卷回答（默认 `preview: true` 仅预览，需显式确认才提交）
`minimax_new_task`	新建任务页（优先 CDP 触发，次选快捷键）
`minimax_open_session`	导航切换至指定会话
`minimax_click_text`	查找并点击指定文本控件（无视窗口缩放与位移）
`minimax_activate`	将 MiniMax 窗口唤醒至系统前台并返回焦点窗口信息
`minimax_screenshot`	窗口截图（支持全屏 screen 或区域 region，返回文件路径）
`minimax_click` / `minimax_type` / `minimax_key`	基础键鼠操作原语

3. 高级协同与自动化

工具名	说明
`minimax_watch`	主动巡检：对比历史快照，按安全策略自动处理低风险事件
`minimax_bot_message`	与 MiniMax Bot 团队沟通（发送群聊消息、指定成员或读取对话）
`minimax_auto_resume`	智能断点续传：额度耗尽（2056）自动检测与恢复重试

🔒 三档安全分级与审计

所有工具均带有 MCP 标准 annotations，并划分为三档安全等级：

read（只读）：完全无副作用，任意调用。
ui（轻量控制）：仅改变界面焦点、截图或导航，完全可逆。
commit（不可逆动作）：发送消息、提交问卷回答、终止生成。所有 commit 级工具均有默认关闭的闸门（如 send: false, preview: true），必须显式参数才会生效。

所有 ui 与 commit 动作均自动脱敏写入本地审计日志：~/.minimax-mcp/audit.jsonl。

🚀 快速开始

1. 环境依赖

操作系统：macOS
运行环境：Node.js >= 22、Python 3、SQLite 3（系统自带）
客户端：已安装并登录的 MiniMax Code

2. 安装与配置

克隆仓库并安装依赖：

git clone https://github.com/Luckycat133/minimax-mcp.git
cd minimax-mcp
npm test                  # 运行全套契约与逻辑测试（129+ 断言全绿）
npm run doctor            # 环境依赖与权限自检

3. 客户端 MCP 配置

在 Claude Desktop / Cursor / Antigravity 的 MCP 配置文件中添加：

{
  "mcpServers": {
    "minimax-mcp": {
      "command": "node",
      "args": [
        "/Users/jack/Documents/projects/minimax-mcp/mcp-server.js"
      ],
      "env": {
        "MINIMAX_PYTHON": "python3",
        "MINIMAX_SQLITE_BIN": "sqlite3"
      }
    }
  }
}

注：将上述路径替换为你的实际项目路径；若通过 npm link 全局链接，也可直接使用 minimax-mcp 命令。

4. 启用 CDP 极速控制（推荐）

通过开启 Remote Debugging 端口，可让 MiniMax MCP 获得极速 DOM 操作能力且无需任何 macOS 系统辅助权限：

node scripts/launch-with-debug.js

🤖 定时巡检后台服务

可将主动巡检配置为 macOS launchd 守护进程：

node scripts/install-watch-agent.js               # 安装守护进程（每 5 分钟自动巡检一轮）
node scripts/install-watch-agent.js --uninstall   # 卸载守护进程

巡检产物将持久化保存在 ~/.minimax-mcp/ 目录下：

report.md：最新态势 Markdown 报告
events.jsonl：待处理与已处理事件队列
watch-state.json：增量对比状态与策略配置
audit.jsonl：操作审计记录

📄 开源许可证

本项目采用 MIT 许可证。

Available Tools

27 tools

minimax_activateactivateA

Idempotent

将 MiniMax 窗口唤醒至系统前台并返回焦点窗口信息。

Inputs: no named parameters.

minimax_answer_questionanswer questionA

Destructive

提交问卷回答。默认 preview=true 仅预览点击计划；preview=false 且 force=true 才实际提交。

Inputs: requestId (required), at, id, force, +2 more.

minimax_auto_resumeauto resumeA

Destructive

智能断点续传：自动识别因额度耗尽(2056)而挂起的会话，在额度恢复后自动继续（原生对话点播放键，Bot 对话推进轮次）。

Inputs: limit, dryRun, sessionId.

minimax_bot_messagebot messageC

Destructive

与 MiniMax Bot 团队沟通：向指定群聊或 Bot 发送指令，或读取团队最新对话。

Inputs: text, limit, action, chatId.

minimax_briefbriefB

Read-onlyIdempotent

态势快照：按等你决定>报错>卡住>运行中优先级输出需关注的会话。纯读数据库，巡检首选。

Inputs: limit, activeMinutes, stalledMinutes, finishedMinutes.

minimax_clickclickA

向屏幕绝对坐标派发鼠标点击事件(仅在非CDP备选模式下使用)。

Inputs: x (required), y (required), button.

minimax_click_textclick textA

查找并点击指定文本(按钮/菜单项)。优先走 CDP DOM 直连，无视窗口遮挡与缩放。

Inputs: text (required), mode, index, query, +1 more.

minimax_draft_answerdraft answerB

Read-onlyIdempotent

为待回答问卷生成草稿回答建议，只读无副作用。

Inputs: requestId (required), id.

minimax_eventseventsA

Read-only

读取巡检事件队列(finished/error/question/stalled/task_failed)。纯读无副作用。

Inputs: limit, since.

minimax_find_textfind textB

Read-onlyIdempotent

在界面中查找文本元素并返回坐标(优先CDP DOM，自动回退OCR)。只读。

Inputs: text (required), mode, index, query, +2 more.

minimax_get_resultget resultB

Read-only

获取指定会话最近一轮任务执行结果，判断是否完成及提取最后产出。

Inputs: session, sessionId, sinceMessageId, timeoutSeconds.

minimax_keykeyC

派发键盘单键或快捷键组合(如 Return、cmd+n)。

Inputs: key (required), modifiers.

minimax_list_sessionslist sessionsA

Read-onlyIdempotent

列出 MiniMax 会话列表，按最后活跃时间倒序，返回会话 ID 及序号。

Inputs: limit.

minimax_new_tasknew taskB

新建任务。优先通过 CDP DOM 触发或快捷键切换至新建任务视图。

Inputs: no named parameters.

minimax_open_sessionopen sessionB

在 MiniMax 界面中导航至指定会话(支持侧栏匹配与 DeepLink)。

Inputs: sessionId (required), session.

minimax_pendingpendingA

Read-onlyIdempotent

查询等待人工确认或答复的问卷与审批卡片。

Inputs: no named parameters.

minimax_read_sessionread sessionB

Read-onlyIdempotent

读取指定会话的历史消息。session 支持会话 ID (mvs_*) 或列表序号。

Inputs: session (required), limit, before, sessionId, +1 more.

minimax_screenshotscreenshotB

Idempotent

获取 MiniMax 窗口截图。支持全屏(screen)或区域(region)，返回图片路径。

Inputs: x, y, mode, name, +2 more.

minimax_searchsearchB

Read-onlyIdempotent

跨会话全文检索标题与消息内容，返回高亮聚焦上下文。

Inputs: query (required), q, limit.

minimax_send_messagesend messageB

Destructive

向当前会话输入或发送消息。CDP直连无需坐标；send=true触发发送；带活跃防误触守卫。

Inputs: message (required), at, send, text, +5 more.

minimax_statusstatusA

Read-onlyIdempotent

获取 MiniMax Code 本地状态：数据库连接、会话数、消息总数及后台任务。

Inputs: no named parameters.

minimax_stop_generationstop generationC

终止当前正在生成或运行中的会话任务。

Inputs: force, session, sessionId.

minimax_tail_sessionstail sessionsB

Read-onlyIdempotent

快速采样最近 N 个会话的末尾消息，用于并发任务巡检。

Inputs: count, perSession.

minimax_taskstasksC

Read-onlyIdempotent

查询 MiniMax 后台任务状态(running/succeeded/failed/canceled)。

Inputs: limit, status.

minimax_typetypeB

向当前富文本输入框注入文本。优先CDP直连，无需前台置顶。

Inputs: text (required), force.

minimax_watchwatchC

Destructive

周期巡检：比对快照产出事件，可按安全策略自动处理低风险问卷。dryRun=true 仅预览。

Inputs: action, dryRun, policy, stalledMinutes, +1 more.

minimax_windowswindowsA

Read-onlyIdempotent

获取 MiniMax 窗口坐标与布局信息，用于坐标校验与置顶检查。

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.2/5.0

Scored 2026-11-07 22:00 across 27 tools

Disambiguation3/5

Several read-oriented tools overlap heavily: read_session, tail_sessions, get_result, brief, events, and pending all surface session/task state with only subtle differences in aggregation level. Similarly click vs click_text vs find_text and type vs send_message have fuzzy boundaries, though descriptions do explain the CDP-vs-coordinate fallback distinction.

Naming Consistency4/5

All tools share the minimax_ prefix and snake_case, which is highly predictable. The only deviation is that some names are bare nouns (search, pending, tasks, brief, events, key) while others are verb_noun (read_session, send_message, answer_question), making the verb-style cue slightly inconsistent.

Tool Count3/5

At 27 tools the surface is on the heavy side, and a few (tail_sessions, brief, click vs click_text) look derivable from other tools. The broad scope—session management, desktop automation, questionnaires, bot comms—justifies most of them, but it is borderline bloated.

Completeness4/5

Coverage of the domain is strong: session list/read/search, task lifecycle, generation stop, messaging, UI automation, screenshots, navigation, questionnaire answering, and monitoring are all present. Minor gaps exist around session lifecycle operations such as deleting/renaming sessions or editing previously sent messages.

Resources

Related MCP Connectors

PrometheorA
com.prometheor
Your AI apps as one team: hand work to Codex or Claude Code on your Mac, with a shared logbook.
Agent Orchestration Coding Agents Knowledge & Memory
161
https://app.prometheor.com/mcp
Dobby
io.github.gil-dobby
Connect, monitor, and control AI agents — tasks, approvals, schedules, and governance.
Agent Orchestration Autonomous Agents Monitoring
2
https://mcp.dobby-ai.com/mcp
PC Remote Commander
io.github.pcremotecommander
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
File Systems Command Line Browser Automation
11
https://pc-remote-commander.pcremotecommander.workers.dev/mcp
Local CommanderB
app.localcmd
Give your AI hands on every computer you own. Remote control of your Windows, Mac and Linux machines from one ChatGPT, Claude or Cursor chat — even from your phone. Ask it to find out why the office server is crawling, update every PC in the house, sort out your mom's laptop from another city, or ship the site from your work machine while you're on a train. It runs commands, reads files and takes a screenshot when it needs to see the screen. You decide what each computer allows, and you can cut any of them off in a second.
CI/CD & DevOps Command Line OS Automation
251
https://localcmd.app/mcp

Related MCP Servers

servo-mcp
OS Automation Autonomous Agents
d11r
A
license
Not graded
quality
D
maintenance
Enables AI agents to see and control your desktop with tools for screenshots, clicks, typing, and more, all locally on macOS and Windows.
Updated 10 months ago (2026-01-14 15:38 UTC)
210 npm
MIT
mcp-macos
OS Automation File Systems Shell Access
dockndevai
A
license
A
quality
B
maintenance
Enables an AI agent to safely observe and operate a Mac, starting read-only with optional read-write and admin tools for files, processes, apps, shell, AppleScript, and GUI control behind explicit permissions and human approval.
Updated 8 days ago (2026-11-02 03:46 UTC)
8
39 npm
MIT
Open Computer Use
OS Automation App Automation Autonomous Agents
aibo204
A
license
Not graded
quality
B
maintenance
Enables AI agents to observe and control the user's live desktop by listing apps, reading accessibility trees, and performing clicks, typing, scrolling, dragging, and other input actions with per-action approvals and local audit archives.
Updated 2 months ago (2026-09-11 09:40 UTC)
1
MIT
ManuMCP
File Systems OS Automation Shell Access
ma-nucho-pro
A
license
Not graded
quality
B
maintenance
Enables compatible AI clients to operate a local computer by accessing files, applications, processes, shells, and, on Windows/macOS, graphical desktop controls such as windows, screens, mouse, and keyboard. It runs locally with user permissions and confirmation previews for operations that change the machine.
Updated 2 months ago (2026-09-21 01:07 UTC)
3
MIT

minimax-mcp

🌟 核心特性

🛠️ 工具总览（27 个精细意图工具）

1. 观察与态势感知（只读，零副作用）

2. 界面控制与输入（带安全守卫）

3. 高级协同与自动化

🔒 三档安全分级与审计

🚀 快速开始

1. 环境依赖

2. 安装与配置

3. 客户端 MCP 配置

4. 启用 CDP 极速控制（推荐）

🤖 定时巡检后台服务

📄 开源许可证

Available Tools

Tool Schema Changelog

TDQS

Resources

Related MCP Connectors

Related MCP Servers

servo-mcp

mcp-macos

Open Computer Use

ManuMCP