使用说明
项目简介
EVAI CLI (可扩展的虚拟助手接口命令行工具) 是一个强大的命令行界面,旨在帮助用户轻松创建、管理和执行自定义工具,并利用大型语言模型 (LLM) 的能力。它通过集成 Model Context Protocol (MCP),可以将自定义工具以标准化的方式提供给支持 MCP 协议的 LLM 客户端,例如 Claude Desktop。
主要功能点
- 自定义工具创建: 允许用户借助 LLM 的辅助快速创建自定义工具。
- 工具组织与管理: 支持将工具组织成独立的命令或分组管理,方便用户维护和使用。
- MCP 服务器: 内置 MCP 服务器,可以将创建的工具通过本地服务器暴露,兼容 Claude Desktop 等 MCP 客户端。
- LLM 交互: 支持与 LLM 的集成,可以利用 LLM 生成工具代码和元数据。
- 灵活的工具结构: 工具以 YAML 文件 (元数据) 和 Python 文件 (实现) 的形式存储,结构清晰,易于扩展和维护。
安装步骤
- 环境准备: 确保已安装 Python 3.12 或更高版本,并已安装 pip。
- 克隆仓库:
git clone https://github.com/lherron/evai-cli.git cd evai-cli - 创建虚拟环境 (推荐):
python -m venv .venv source .venv/bin/activate # Linux/macOS .venv\Scripts\activate # Windows - 安装 EVAI CLI:
pip install -e ".[dev]"
服务器配置
为了让 MCP 客户端 (如 Claude Desktop) 连接到 EVAI CLI 提供的 MCP 服务器,您需要在客户端中配置服务器连接信息。以下是 EVAI CLI 服务器的 JSON 格式配置示例:
{ "serverName": "evai", "command": "evai", "args": ["server", "start"] }
- 'serverName': 服务器名称,可以自定义,例如 "evai"。
- 'command': 启动 EVAI CLI MCP 服务器的命令,这里是 'evai',假设 'evai' 命令已添加到系统 PATH 环境变量中。
- 'args': 传递给 'evai' 命令的参数,用于启动 MCP 服务器,这里使用 '["server", "start"]' 命令启动服务器。
基本使用方法
- 查看帮助: 运行 'evai --help' 查看 EVAI CLI 的基本命令和选项。
- 添加新工具: 使用 'evai llm add <工具名称>' 命令,通过 LLM 辅助创建新工具。
- 列出工具: 运行 'evai tools list' 查看所有可用的工具和工具组。
- 编辑工具: 使用 'evai tools edit <工具名称>' 编辑现有工具的元数据和实现代码。
- 运行工具: 使用 'evai <工具名称> [参数]' 运行已创建的工具。
- 启动 MCP 服务器: 运行 'evai server start' 启动 MCP 服务器,将工具暴露给 MCP 客户端。
示例
启动 MCP 服务器后,您可以在 Claude Desktop 或其他 MCP 客户端中配置连接到该服务器,从而在 LLM 应用中使用 EVAI CLI 中创建的自定义工具。
信息
分类
开发者工具