使用说明

项目简介

EVAI CLI (可扩展的虚拟助手接口命令行工具) 是一个强大的命令行界面,旨在帮助用户轻松创建、管理和执行自定义工具,并利用大型语言模型 (LLM) 的能力。它通过集成 Model Context Protocol (MCP),可以将自定义工具以标准化的方式提供给支持 MCP 协议的 LLM 客户端,例如 Claude Desktop。

主要功能点

  • 自定义工具创建: 允许用户借助 LLM 的辅助快速创建自定义工具。
  • 工具组织与管理: 支持将工具组织成独立的命令或分组管理,方便用户维护和使用。
  • MCP 服务器: 内置 MCP 服务器,可以将创建的工具通过本地服务器暴露,兼容 Claude Desktop 等 MCP 客户端。
  • LLM 交互: 支持与 LLM 的集成,可以利用 LLM 生成工具代码和元数据。
  • 灵活的工具结构: 工具以 YAML 文件 (元数据) 和 Python 文件 (实现) 的形式存储,结构清晰,易于扩展和维护。

安装步骤

  1. 环境准备: 确保已安装 Python 3.12 或更高版本,并已安装 pip。
  2. 克隆仓库:
    git clone https://github.com/lherron/evai-cli.git
    cd evai-cli
  3. 创建虚拟环境 (推荐):
    python -m venv .venv
    source .venv/bin/activate  # Linux/macOS
    .venv\Scripts\activate  # Windows
  4. 安装 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 中创建的自定义工具。

信息

分类

开发者工具