关键词

AI代理框架上下文服务工具执行资源管理企业应用

Open Manus 使用说明

项目简介

Open Manus 是一个开源项目，旨在构建类似 MCP 服务器的功能，为 AI 代理提供上下文服务。它通过管理工具、资源和 Prompt 模板，帮助 AI 代理更有效地与外部环境交互。Open Manus 专注于提供可扩展和企业友好的 AI 系统框架，特别针对企业级应用场景。

主要功能点

  • 工具 (Tools) 管理与执行: 支持 AI 代理调用预定义的工具，例如执行 Shell 命令、编辑文件等，扩展 AI 的能力边界，使 AI 能够执行更复杂的操作。
  • 资源 (Resources) 管理: 通过文件系统和容器运行时环境，提供数据访问和操作能力，让 AI 可以获取和处理外部数据。
  • Prompt 模板 (Prompts) 渲染: 虽然代码中没有直接体现 Prompt 模板的明确管理，但项目架构支持基于 Prompt 的计划生成和任务执行流程，为定制化 LLM 交互模式奠定基础。
  • 可扩展架构: 模块化设计，易于添加新功能和集成外部服务，方便用户根据自身需求进行扩展和定制。
  • 容器化环境: 使用 Docker 容器提供隔离的运行时环境，增强安全性和可控性，适用于企业级应用的部署需求。

安装步骤

  1. 克隆仓库:

    git clone https://github.com/shareAI-lab/open-Manus.git
cd open-Manus/api

  2. 安装依赖: 建议使用 'uv' 进行依赖管理，确保环境一致性。

    python scripts/manage_deps.py install
    • 确保已安装 'uv' (可以使用 'pip install uv' 安装)。

  3. 配置环境变量: 复制 '.env.example' 文件为 '.env'，并根据需要修改其中的配置，例如 OpenAI API 密钥等。

  4. 启动服务器:

    uvicorn main:app --reload

    默认服务器将在 'http://0.0.0.0:8000' 启动。

服务器配置 (MCP 客户端配置)

要让 MCP 客户端连接到 Open Manus 服务器，你需要提供以下配置信息。请注意，Open Manus 目前可能不完全兼容标准的 MCP 协议，但以下配置提供了连接所需的基本信息。

{
  "serverName": "OpenManusServer",
  "command": "uvicorn",
  "args": [
    "main:app",
    "--host", "0.0.0.0",
    "--port", "8000",
    "--reload"
  ],
  "protocol": "http",
  "host": "服务器IP地址或域名",
  "port": 8000,
  "apiPath": "/api"
}

配置参数说明:

  • 'serverName': 服务器名称，可以自定义。
  • 'command': 启动服务器的命令，固定为 'uvicorn'。
  • 'args': 启动命令的参数，请勿修改，保持与示例一致。
  • 'protocol': 使用的协议，固定为 'http'。
  • 'host': Open Manus 服务器的 IP 地址或域名，请根据实际部署情况填写。
  • 'port': Open Manus 服务器监听的端口号，固定为 '8000'。
  • 'apiPath': API 基础路径，固定为 '/api'。

重要提示:

  • 协议兼容性: Open Manus 可能不完全兼容 标准 MCP 协议的 JSON-RPC 通信方式。上述配置基于项目代码的 RESTful API 接口推测的 HTTP 配置。实际连接和通信方式需要根据 MCP 客户端的具体要求以及 Open Manus 项目的后续发展进行调整。
  • 功能完整性: Open Manus 项目目前处于早期阶段，可能只实现了 MCP 服务器部分核心功能，完整 MCP 协议的支持程度需要进一步评估。
  • 安全性: 生产环境部署时，请务必考虑安全性配置，例如移除 '--reload'，配置 HTTPS，以及进行必要的安全加固。

基本使用方法

启动服务器后，你可以通过 HTTP 请求访问 Open Manus 提供的 API 接口。例如，使用 POST 请求到 '/api/manus/generate-plan' 接口，可以触发对话计划生成功能。

具体的 API 接口和参数，请参考 Open Manus 项目的 API 文档 (通常可以通过访问 'http://服务器IP:端口/api/docs' 查看 Swagger 文档，如果项目已启用)。

信息

分类

AI与计算

访问项目