Mind MCP Server

mind mcp-server 通过标准输入输出运行 MCP 服务，供 Codex 或其他 MCP host 调用 Mind agent。stdout 只承载 MCP JSON-RPC；启动错误和协议日志写入 stderr。

工具

服务提供一个工具：mind_exec。

参数	类型	默认值	说明
`prompt`	`string`	必填	本次任务内容。
`sandbox_mode`	`read-only \\| workspace-write \\| danger-full-access \\| null`	配置值或 `read-only`	沙箱边界。
`approval_policy`	`untrusted \\| on-request \\| never \\| null`	配置值或 `never`	工具审批策略。
`working_directory`	`string \\| null`	MCP 进程工作目录	可选的任务工作目录，必须已经存在。
`timeout_sec`	`number \\| null`	`900`	整次请求的超时秒数，包含等待串行调用锁的时间；传 `null` 可关闭服务端超时。
`session_id`	`string \\| null`	`null`	传入先前返回的会话标识，在同一工作目录续接对话。

返回值包含 status、assistant_text、usage、error、exit_code 和 session_id。不传 session_id 时开始独立对话；需要继续时，把上次返回的 session_id 原样传入。会话游标只保存 24 小时，并且只能在创建它的工作目录恢复。

同一服务进程内的调用会串行执行，避免共享 workspace、conversation 和工具运行时发生竞争。MCP host 发送标准 notifications/cancelled 后，取消会沿当前 mind_exec 协程传播到底层模型和工具调用，并释放串行调用锁。服务端超时会取消同一条执行链，返回 status=failed 和超时原因；客户端主动取消时按照 MCP 规范不再返回重复结果。

Codex 配置

打包安装：

codex mcp add mind -- mind mcp-server
codex mcp get mind --json

源码模式：

codex mcp add mind -- python D:\PycharmProjects\ProxyMind\mind.py mcp-server

第一个 -- 由 Codex 解析，表示后续内容是 stdio server 的启动命令。它不是 mind 的参数。

通用配置

使用 JSON 配置的 MCP host 可以采用以下结构：

{
  "mcpServers": {
    "mind": {
      "command": "mind",
      "args": ["mcp-server"]
    }
  }
}

源码模式把 command 改为 Python 可执行文件，并把 mind.py 的绝对路径放在 args 第一项。

生命周期

服务启动时会：

解析源码或打包入口的 schematic/supports 路径。
读取 ~/.mind/config.toml。
接入 Mind native tools 和已启用的外部 MCP。
等待 MCP host 调用 mind_exec，并处理请求取消、超时和可选会话续接。

MCP host 断开后，服务会关闭外部 MCP、native coding runtime 和运行报告。服务不会自动启动 Helix，也不提供远程 HTTP transport。

不要在 Mind 自己的 ~/.mind/config.toml 的 [mcp_servers] 中配置 mind mcp-server。Mind 服务启动时会读取这些外部服务，把自身放进去会形成递归子进程。