OpenManus C++版本

这是OpenManus项目的C++实现版本，旨在提供与原始Python版本相同的功能。

项目结构

cpp/
├── include/            # 头文件目录
│   ├── agent_base.h    # 代理基类
│   ├── manus.h         # Manus代理
│   ├── tool_base.h     # 工具基类
│   ├── tool_call.h     # 工具调用类
│   ├── tool_call_agent.h # 工具调用代理
│   ├── tool_collection.h # 工具集合类
│   ├── flow/           # 流程头文件目录
│   │   ├── base_flow.h # 流程基类
│   │   ├── planning_flow.h # 规划流程
│   │   └── flow_factory.h # 流程工厂
│   └── tools/          # 工具头文件目录
│       └── terminate.h # 终止工具
├── src/                # 源文件目录
│   ├── agent_base.cpp  # 代理基类实现
│   ├── manus.cpp       # Manus代理实现
│   ├── tool_base.cpp   # 工具基类实现
│   ├── tool_call.cpp   # 工具调用类实现
│   ├── tool_call_agent.cpp # 工具调用代理实现
│   ├── tool_collection.cpp # 工具集合类实现
│   ├── flow/           # 流程实现目录
│   │   ├── base_flow.cpp # 流程基类实现
│   │   ├── planning_flow.cpp # 规划流程实现
│   │   └── flow_factory.cpp # 流程工厂实现
│   └── tools/          # 工具实现目录
│       └── terminate.cpp # 终止工具实现
├── server/             # MCP服务器目录
│   ├── mcp_server_main.cpp # MCP服务器主程序
│   └── CMakeLists.txt  # 服务器构建文件
├── main.cpp            # 主程序入口
├── mcp/                # MCP协议库
└── CMakeLists.txt      # CMake构建文件

已完成工作

1. 基础框架搭建

   • 创建了基本的项目结构和CMakeLists.txt文件
   • 实现了基础代理类(AgentBase)
   • 实现了工具集合类(ToolCollection)
   • 实现了工具基类(ToolBase)
   • 实现了工具调用类(ToolCall)
   • 实现了工具调用代理类(ToolCallAgent)
   • 实现了Manus代理类

2. 流程层实现

   • 实现了流程基类(BaseFlow)
   • 实现了规划流程(PlanningFlow)
   • 实现了流程工厂(FlowFactory)
   • 修改了主程序，使用流程层执行任务

3. 工具实现

   • 实现了终止工具(Terminate)，用于终止代理执行
   • 实现了Python执行工具(PythonExecute)，可以执行Python代码

4. MCP服务器

   • 实现了基本的MCP服务器
   • 实现了PythonExecute工具，可以执行Python代码

5. LLM集成

   • 使用httplib.h实现了与LLM API的通信
   • 实现了think方法，能够调用LLM API获取下一步行动
   • 实现了工具调用的解析和执行
   • 添加了Authorization头部，支持API密钥认证

6. 配置系统

   • 实现了TOML格式的配置文件读取
   • 支持从配置文件中读取LLM API、工具和代理等参数
   • 支持在运行时指定配置文件路径

7. 编译与运行

   • 成功编译并运行了基本框架
   • 解决了与MCP协议库的集成问题

未完成工作

1. 工具实现

   • Google搜索工具(GoogleSearch)
   • 浏览器使用工具(BrowserUseTool)
   • 文件保存工具(FileSaver)
   • 其他工具...

2. LLM集成完善

   • 添加更多的LLM模型支持
   • 实现流式响应处理
   • 添加更多的提示模板

3. MCP协议完整集成

   • 完善客户端与MCP服务器的通信
   • 实现完整的请求-响应流程

4. 错误处理与日志

   • 添加更完善的错误处理机制
   • 实现日志记录功能

5. 测试与文档

   • 编写单元测试
   • 编写集成测试
   • 完善API文档

配置文件

OpenManus使用TOML格式的配置文件来配置LLM API、工具和代理等参数。默认配置文件为config.toml，位于可执行文件所在目录。

配置文件示例

# OpenManus配置文件

[llm]
# LLM API主机
host = "localhost"
# LLM API端口
port = 8000
# LLM API路径
path = "/chat/completions"
# LLM API密钥
api_key = "your_api_key_here"
# LLM模型名称
model = "gpt-3.5-turbo"
# 是否启用流式响应
stream = false

[tools]
# 是否启用Python执行工具
enable_python_execute = true
# 是否启用Google搜索工具
enable_google_search = false
# 是否启用浏览器使用工具
enable_browser_use = false
# 是否启用文件保存工具
enable_file_saver = false

[agent]
# 最大步骤数
max_steps = 30
# 系统提示
system_prompt = "你是Manus，一个通用的智能助手，可以使用多种工具解决各种任务。"
# 下一步提示
next_step_prompt = "请思考下一步行动，使用可用的工具来解决用户的问题。"

运行时指定配置文件

可以在运行时通过命令行参数指定配置文件路径：

./openmanus_cpp /path/to/your/config.toml

构建与运行

构建主程序

cd cpp
mkdir -p build
cd build
cmake ..
make

运行主程序

./openmanus_cpp

构建MCP服务器

cd cpp/server
mkdir -p build
cd build
cmake ..
make

运行MCP服务器

./openmanus_mcp_server

依赖

• C++17
• CMake 3.10+
• nlohmann/json (包含在mcp/common目录中)
• httplib.h (包含在项目中)
• Python 3 (用于PythonExecute工具)
• LLM API服务 (如OpenAI API或本地部署的LLM服务)

许可证

与原始OpenManus项目相同的许可证。