项目简介

Light MCP Agents 是一个轻量级框架，旨在帮助开发者构建和编排基于模型上下文协议（MCP）的智能 Agent。该框架支持创建分层结构的 Agent 系统，使得不同的 Agent 可以相互协作、委派任务和共享能力，从而解决复杂的 AI 问题。

主要功能点

Agent 服务化: 可以将 Agent 作为 MCP 服务器运行，对外提供工具和能力，遵循 MCP 协议标准。
分层 Agent 架构: 支持创建多层 Agent 系统，构建复杂的 Agent 协作网络，高层 Agent 可以调度低层 Agent 的能力。
工具集成: 允许 Agent 集成和使用来自不同 MCP 服务器提供的工具，扩展 Agent 的功能。
能力 (Capability) 定义: 支持将 Agent 的特定功能封装为 Capability，通过 Prompt 模板和 LLM 推理实现更高级的任务。
配置驱动: Agent 的配置通过 JSON 文件进行管理，方便用户自定义 Agent 的行为和能力。

安装步骤

克隆仓库

git clone https://github.com/nicozumarraga/light-mcp-agents.git
cd light-mcp-agents

创建并激活虚拟环境

python -m venv venv
source venv/bin/activate   # Linux/macOS
# venv\Scripts\activate  # Windows

安装依赖

pip install -r requirements.txt

服务器配置

MCP 客户端需要配置以下 JSON 格式的服务器信息以连接到 Light MCP Agents 服务器：

{
  "server-name": "my-agent-server",  // MCP 服务器名称，客户端连接时使用，可自定义
  "command": "python",             // 启动 MCP 服务器的命令，通常为 python 解释器
  "args": ["src/agent/agent_runner.py", "--config=my_agent_config.json", "--server-mode"] // 启动命令的参数，指定 Agent 配置文件路径和 server-mode 运行模式
}

'server-name': 为 MCP 服务器指定一个名称，客户端将使用此名称来连接服务器。您可以自定义此名称。
'command': 运行 MCP 服务器的命令，通常是您系统中的 Python 解释器路径。
'args': 传递给启动命令的参数列表。
- '"src/agent/agent_runner.py"': 指定运行 'agent_runner.py' 脚本，该脚本负责启动 Agent 服务。
- '"--config=my_agent_config.json"': 指定 Agent 的配置文件路径。您需要根据实际情况替换 'my_agent_config.json' 为您的配置文件路径。
- '"--server-mode"': 重要的参数，用于告知 'agent_runner.py' 以 MCP 服务器模式启动 Agent。

注意: 'my_agent_config.json' 是 Agent 的配置文件示例，您需要根据您的需求创建或修改该文件，配置 LLM API 密钥、Agent 名称、需要连接的工具服务器等。

基本使用方法

配置 Agent: 根据 'examples/' 目录下的示例，创建或修改 Agent 的配置文件 ('.json' 文件)，例如配置 LLM provider 和 API Key，以及需要连接的工具服务器。

启动 MCP 服务器: 使用以下命令启动 Agent 作为 MCP 服务器 (请替换为您实际的配置文件路径)：

python src/agent/agent_runner.py --config <your_agent_config.json> --server-mode --server-name my-agent-server

将 '<your_agent_config.json>' 替换为您的 Agent 配置文件路径，'my-agent-server' 可以替换为您自定义的服务器名称。

客户端连接: 在 MCP 客户端 (例如另一个 Light MCP Agents Agent 或其他 MCP 客户端应用) 中，配置上述 “服务器配置” 中描述的连接信息，即可连接到该 MCP 服务器并使用其提供的工具和能力。

启动成功后，Light MCP Agents 将作为一个 MCP 服务器运行，等待客户端连接并提供服务。您可以通过 MCP 客户端向该服务器发送请求，利用其提供的工具和能力。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息