返回 MCP 目录
public公开dns本地运行

the-mcp-company

OpenHands克隆项目,用于AI代理评估,支持浏览器工具、预言机工具集和工具检索功能

article

README

🚀 OpenHands克隆项目

这是 OpenHands 提交版本 91cd647f207ccf30c09e1ebf99ac6c3c22cfda64 的克隆项目,并进行了一些修改以实现 MCPAgent。

🚀 快速开始

📦 安装指南

在运行安装过程之前,请确保你位于此目录(从仓库根目录执行 cd OpenHands)。 按照 这些说明 设置用于评估的开发环境。以下是总结:

  • 确保已安装 Docker 和 Poetry,并且你使用的是 python==3.12NodeJS >= 22.x
  • 在 Ubuntu 系统上,你还需要安装 build-essential(执行 sudo apt install build-essential)。在 WSL 上,你需要安装 netcat(执行 apt install netcat)。
  • 运行 make build,这将需要一些时间才能完成。

💻 使用示例

运行评估

对于使用工具检索或神谕工具集的实验,首先要确保正确的 MCP 服务器正在运行(说明见 此处)。 此外,对于所有实验,在 config.toml 文件的 [llm.agent] 键下设置你的大语言模型配置(例如,模型名称、认证令牌等)。

TheAgentCompany 任务
  • 可访问浏览器工具的代理config.toml 文件进行以下更改:

    • [agent] 下设置 system_prompt_filename='system_prompt_cua.j2' 从当前目录运行 bash run_all_agc.sh cua
  • 可访问神谕工具集的代理config.toml 文件进行以下更改:

    • [agent] 下设置 system_prompt_filename='system_prompt_gt_tools.j2'
    • [agent] 下设置 enable_browsing=false
    • 取消注释以下行:
[mcp]
sse_servers = ["http://localhost:7879/sse"]

从当前目录运行 bash run_all_agc.sh gt_tools

  • 具有工具检索功能的代理(MCPAgent)config.toml 文件进行以下更改:
    • [agent] 下设置 system_prompt_filename='system_prompt_find_tools.j2'
    • [agent] 下设置 enable_browsing=false
    • 取消注释以下行:
[mcp]
sse_servers = ["http://localhost:7879/sse"]

从当前目录运行 bash run_all_agc.sh dense_retrieval

Azure 任务

确保具有工具检索功能的 MCP 服务器正在运行。 在 config.toml 文件的 [llm.agent] 键下设置你的大语言模型配置(例如,模型名称、认证令牌等)。 对 config.toml 文件进行以下更改:

  • [agent] 下设置 system_prompt_filename='system_prompt_find_tools.j2'
  • [agent] 下设置 enable_browsing=false
  • 取消注释以下行:
[mcp]
sse_servers = ["http://localhost:7879/sse"]

从当前目录运行 RUN_AZURE_TASKS=true bash run_all_agc.sh dense_retrieval

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端