XP

x-plug/osworld-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

239 stars 24 forks 质量 55 趋势 22

x-plug/osworld-mcp 是从 https://github.com/x-plug/osworld-mcp. 导入的 MCP 服务器候选

概览

x-plug/osworld-mcp 是从 https://github.com/x-plug/osworld-mcp. 导入的 MCP 服务器候选

概述(AI 翻译)

🔔 更新

2026-05-13: 你可能还会感兴趣:ToolCUA:迈向计算机使用代理的最佳图形界面-工具路径编排。

2026-05-09: 修复了 LibreOffice MCP 工具中的 bug。新增模型结果:Kimi-K2.5、Gemini-3.1-Pro、Claude-4.5-Sonnet 和 Qwen3.5-Plus。

2026-01-26: OSWorld-MCP已被接受加入ICLR 2026!🎉

2025-10-28: 我们发布了论文和项目页面!🎉

📄 阅读论文  |  🌐 访问项目页面


📑 概述与主要亮点

OSWorld-MCP 是一个全面且公平的基准测试,用于评估现实场景中计算机使用代理。 它共同衡量了**模型上下文协议(MCP)**工具调用能力、图形用户界面(GUI)操作技能以及决策性能。 作为 OSWorld 的扩展,它显著提升了真实性、平衡性和评估的可比性。

主要特征与发现

  • 158 个经过验证的 MCP 工具,涵盖 7 个常见应用(LibreOffice Writer、Calc、Impress、VS Code、Google Chrome、VLC、操作系统工具)。其中包括 **25 个用于稳健性测试的干扰工具

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

OSWorld-MCP: Benchmarking MCP Tool Invocation in Computer-Use Agents

🔔 Updates

2026-05-13: You Might also be interested: ToolCUA: Towards Optimal GUI-Tool Path Orchestration for Computer Use Agents.

2026-05-09: Fixed bugs in LibreOffice MCP tools. New model results added: Kimi-K2.5, Gemini-3.1-Pro, Claude-4.5-Sonnet, and Qwen3.5-Plus.

2026-01-26: OSWorld-MCP is accepted to ICLR 2026! 🎉

2025-10-28: We released our paper and project page! 🎉

📄 Read the Paper  |  🌐 Visit the Project Page


📑 Overview & Key Highlights

OSWorld-MCP is a comprehensive and fair benchmark for evaluating computer-use agents in real-world scenarios.
It jointly measures Model Context Protocol (MCP) tool invocation capabilities, graphical user interface (GUI) operation skills, and decision-making performance.
Designed as an extension of OSWorld, it significantly improves realism, balance, and comparability in evaluation.

Key Features & Findings

  • 158 validated MCP tools, spanning 7 common applications (LibreOffice Writer, Calc, Impress, VS Code, Google Chrome, VLC, OS utilities). Among them, 25 distractor tools for robustness testing
  • 250 tool-beneficial tasks → 69% of benchmark tasks benefit from MCP tools
  • Multi-round tool invocation possible, posing real decision-making challenges
  • MCP tools boost model accuracy & efficiency — e.g., OpenAI o3: 8.3% → 17.6% (15 steps)
  • Highest observed Tool Invocation Rate (TIR) = 33.3% (Claude-4-Sonnet, 50 steps) → indicating ample room for improvement
  • MCP tools improve agent metrics
  • Higher tool invocation correlates with higher accuracy
  • Combining tools introduces significant challenges

Architecture Overview


Figure: OSWorld-MCP evaluation framework integrating GUI actions and MCP tool invocations.


⚙️ Installation & Usage

1️⃣ Preparation: Code Setup

# Clone OSWorld base repo
git clone https://github.com/xlang-ai/OSWorld.git

# Clone OSWorld-MCP
git clone https://github.com/X-PLUG/OSWorld-MCP.git

Integrate OSWorld-MCP files into OSWorld to enable MCP support.


2️⃣ Preparation: Docker Environment

  1. Copy MCP files into /home inside Docker:
/home/
└── mcp_server/
└── osworld_mcp_client.py
  1. Install dependencies:
pip install -r requirements.txt
  1. Install Node.js
  2. Launch MCP server:
cd mcp_server
bash debug_server.sh

A successful launch opens the local MCP debug UI in your browser.


3️⃣ Running Evaluation

Example: Evaluate Claude 4 Sonnet (15 steps):

python run_multienv_e2e.py \
    --api_url  \
    --api_key  \
    --model 'claude-sonnet-4-20250514-thinking' \
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →