Mnehmos Ooda MCP

mnehmos.oda.mcp（v1.0.0）

](https://www.npmjs.com/package/mnehmos.ooda.mcp) 

一个全面的MCP（模型上下文协议）服务器，为Claude提供完整的计算机控制功能。实现OODA循环（Observe Orient Decide Act）模式，用于自主计算机交互。

特性

总计：100个工具 大多数操作都支持批处理/并行执行。

安全警告

此服务器提供 不受限制的系统访问克劳德将能够：

• 执行任意shell命令
• 控制键盘和鼠标
• 截图
• 在任何地方读/写文件
• 管理窗口和进程

仅在受信任的环境中使用，风险自负。

安装

来自npm（推荐）

npm install -g mnehmos.ooda.mcp

来源

git clone https://github.com/Mnehmos/mnehmos.ooda.mcp.git
cd mnehmos.ooda.mcp
npm install
npm run build

Claude桌面配置

添加到您的Claude Desktop配置文件中：

视窗: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

如果通过npm安装：

{
  "mcpServers": {
    "ooda-computer": {
      "command": "npx",
      "args": ["mnehmos.ooda.mcp"]
    }
  }
}

如果从源代码安装：

{
  "mcpServers": {
    "ooda-computer": {
      "command": "node",
      "args": ["/absolute/path/to/mnehmos.ooda.mcp/dist/index.js"]
    }
  }
}

OODA循环模式

这些工具是围绕OODA（Observe Orient Decide Act）循环设计的：

观察

• screenshot -捕获屏幕或区域（返回base64或保存到文件）
• get_screen_info -获取显示/监视器信息
• wait_for_screen_change -检测屏幕内容何时更改
• list_windows -查看所有打开的应用程序
• get_active_window -了解当前焦点
• clipboard_read -检查剪贴板内容

东方

• 使用CRUD工具存储/检索上下文和状态
• file_info, search_files -了解文件系统状态
• list_processes, get_system_info -了解系统状态

决定

• 克劳德在观察之间的推理
• 用于持久决策上下文的CRUD数据库

法案

• keyboard_type, keyboard_shortcut -键入并使用热键
• mouse_click, mouse_move, mouse_drag -鼠标控制
• focus_window, launch_application -窗口控制
• clipboard_write -设置剪贴板内容
• notify -系统通知

通用批处理调度器

这 batch_tools 调度员可以在具有统一安全限制的批处理模式下执行任何工具：

{
  "tool": "batch_tools",
  "args": {
    "operations": [
      { "tool": "read_file", "args": { "path": "src/index.ts" }, "label": "main" },
      { "tool": "file_info", "args": { "path": "package.json" }, "label": "pkg" },
      { "tool": "exec_cli", "args": { "command": "git status --short" }, "label": "git" }
    ],
    "executionMode": "parallel"
  }
}

执行模式

安全限值

可配置 ~/.mcp/config.json 或根据请求：

看 ADR-003 获取完整文档。

API 参考

CLI和文件操作

基于差异的编辑

CRUD操作

屏幕操作

输入操作

窗口操作

剪贴板操作

系统操作

浏览器自动化

交互式会话

批量操作

大多数工具都有用于并行执行的专用批处理版本：

batch_exec_cli      - Multiple commands in parallel
batch_read_files    - Multiple files in parallel
batch_write_files   - Multiple files in parallel
batch_copy_files    - Multiple copies in parallel
crud_batch_create   - Multiple records in parallel
...

或者使用通用 batch_tools 调度员批量处理任何工具。

批处理操作返回结构化结果：

{
  "summary": { "total": 5, "successful": 4, "failed": 1, "elapsed_ms": 23 },
  "results": [
    { "index": 0, "success": true, "result": {...} },
    { "index": 1, "success": false, "error": "..." }
  ]
}

平台支持

配置

可选配置文件位于 ~/.mcp/config.json:

{
  "storage": {
    "type": "sqlite",
    "path": "~/.mcp/workspace.db"
  },
  "cliPolicy": {
    "mode": "allow-all",
    "extraBlockedPatterns": [],
    "timeoutMs": 30000
  },
  "crud": {
    "defaultLimit": 1000
  },
  "fileReading": {
    "maxLines": 500,
    "warnAtLines": 100
  },
  "batchOperations": {
    "maxOperations": 50,
    "maxAggregateChars": 200000,
    "maxLinesPerFile": 500,
    "defaultTimeout": 30000,
    "toolLimits": {
      "exec_cli": { "maxOperations": 20, "timeout": 60000 }
    }
  }
}

发展

npm install      # Install dependencies
npm run build    # Build TypeScript
npm run dev      # Watch mode
npm test         # Run tests
npm start        # Run server

已知限制

• find_on_screen 需要额外的OCR依赖项（不包括在内）
• macOS鼠标位置读取返回0,0（系统限制）
• 某些鼠标拖动操作可能需要特定于平台的调整

许可证

MIT许可证-请参阅 许可证 文件。

更新日志

看 更改日志.md 版本历史。