关键词

AI智能体框架文件操作任务规划工具集成浏览器自动化

使用说明

项目简介

Mercatus 是一个开源的 AI 智能体框架，它使用 OpenAI 的 Agents SDK 构建，旨在提供类似 Manus 的功能。该框架集成了强大的工具，如浏览器自动化和模型上下文协议 (MCP)，以实现复杂的智能体工作流程。Mercatus 框架的核心功能之一是通过 MCP 文件服务器提供文件操作能力，使得 AI 智能体可以安全、高效地访问和管理文件系统资源。

主要功能点

  • AI 智能体架构: 采用 Plan-Execute-Evaluate 工作流程，使用 OpenAI Agents SDK 构建智能体核心逻辑。
  • MCP 文件服务器集成: 内置 MCP 文件服务器，为智能体提供安全的文件读写能力，支持复杂的文件操作。
  • 浏览器自动化: 集成浏览器自动化工具，允许智能体与网页互动，采集数据，执行在线搜索等任务。
  • 模块化设计: 采用模块化架构，易于扩展，可以添加新的工具和功能模块。
  • 用户友好的命令行界面: 提供简洁的命令行界面，方便用户与智能体进行交互。

安装步骤

  1. 环境准备: 确保已安装 Python 3.12+ 和 Node.js (用于 MCP 工具)。建议使用 'uv' 进行包管理以获得更快的安装速度。

  2. 克隆仓库:

    git clone https://github.com/AIchovy/Mercatus.git
cd Mercatus

  3. 创建虚拟环境:

    uv venv --python 3.12
source .venv/bin/activate   # Unix/macOS
# .venv\Scripts\activate  # Windows

  4. 安装依赖:

    uv pip install -r requirements.txt

  5. 安装浏览器自动化工具 (可选，但推荐):

    playwright install

  6. 配置 API 密钥: 复制 '.env.example' 文件并重命名为 '.env'，然后编辑 '.env' 文件，填入你的 OpenAI API 密钥等必要信息。

    cp .env.example .env
# 编辑 .env 文件

服务器配置

Mercatus 框架内置并管理一个 MCP 文件服务器，无需用户手动配置独立的 MCP 服务器。框架通过 'app/mcps/file.py' 启动和管理文件服务器进程。

对于需要与 Mercatus 集成的 MCP 客户端（例如，您自己的 LLM 应用），您需要配置以下信息以连接到 Mercatus 提供的 MCP 文件服务器。

MCP 服务器配置 (JSON 格式):

{
  "server_name": "file_mcp_server",
  "command": "npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-filesystem",
    "artifacts/files"
  ],
  "transport": "stdio"
}

配置参数注释:

  • 'server_name': 服务器名称，这里设置为 'file_mcp_server'，用于在客户端标识和引用该服务器。
  • 'command': 启动 MCP 文件服务器的命令，这里使用 'npx' 来运行 Node.js 包。
  • 'args': 传递给 'npx' 命令的参数列表：
    • '"-y"': 'npx' 参数，自动确认安装 '@modelcontextprotocol/server-filesystem' 包。
    • '"@modelcontextprotocol/server-filesystem"': 要运行的 Node.js 包，即 MCP 文件系统服务器的实现。
    • '"artifacts/files"': MCP 文件服务器的文件存储根目录，相对于 Mercatus 项目根目录的 'artifacts/files' 文件夹。客户端对文件系统的操作将限制在这个目录下。
  • 'transport': 通信协议，这里设置为 'stdio'，表示使用标准输入输出流进行通信。Mercatus 框架默认使用 Stdio 协议与 MCP 文件服务器通信。

重要提示:

  • 上述 JSON 配置信息是为了MCP 客户端连接 Mercatus 提供的 MCP 文件服务器而准备的。您无需手动启动 MCP 文件服务器，Mercatus 框架会在运行时自动启动和管理它。
  • 'artifacts/files' 目录是 MCP 文件服务器的文件操作根目录。智能体和通过 MCP 客户端连接的应用都只能访问和操作该目录下的文件，确保了文件系统的安全性和隔离性。

基本使用方法

  1. 运行 Mercatus 应用:

    python main.py

  2. 输入目标: 程序启动后，会提示你输入目标 (Please enter your goal: )。输入你的任务目标，例如 "Search for the latest news about AI and save it to a file."，然后回车。

  3. 智能体执行任务: Mercatus AI 智能体将根据你的目标，自动规划任务、调用工具、执行操作，并通过命令行输出结果。

注意事项

  • 首次运行可能需要下载和安装一些依赖，请耐心等待。
  • 确保 '.env' 文件中配置了正确的 OpenAI API 密钥。
  • 'artifacts' 目录用于存放运行时生成的文件，包括浏览器历史记录和 MCP 文件服务器的文件存储。

信息

分类

AI与计算

访问项目