关键词

AI代理命令行工具多模型协作任务监控代码开发

项目简介

CLI Agent MCP是一个基于Model Context Protocol (MCP) 的统一服务器，为AI助手提供调用多种命令行代理的能力，包括代码审查、创意设计、代码实现和全栈开发等多种场景。

主要功能

  • 多模型支持：集成Codex、Gemini、Claude和OpenCode等多种AI代理
  • 请求隔离：每个请求都有独立的执行上下文，支持安全并发使用
  • GUI仪表板：使用pywebview提供实时任务监控
  • 优雅取消：通过SIGINT信号处理实现请求取消而不终止服务器
  • 文件输出：支持将代理输出保存到文件，并可配置XML包装和追加模式
  • 权限控制：支持read-only、workspace-write和unlimited三种权限级别
  • 调试支持：完整的子进程输出捕获和详细日志记录

安装步骤

# 从PyPI安装（发布后）
uvx cli-agent-mcp

# 从GitHub安装
uvx --from git+https://github.com/shiharuharu/cli-agent-mcp.git cli-agent-mcp

# 从源码安装（开发模式）
uvx --from /path/to/cli-agent-mcp cli-agent-mcp

# 使用pip安装
pip install -e .

服务器配置

在MCP客户端配置文件中添加（如Claude Desktop的claude_desktop_config.json）：

{
  "mcpServers": {
    "cli-agent-mcp": {
      "command": "uvx",
      "args": ["cli-agent-mcp"]
}

基本使用方法

  1. 配置环境变量：

    • 'CAM_TOOLS'：允许使用的工具列表（空值表示全部）
    • 'CAM_GUI'：启用GUI仪表板（默认true）
    • 'CAM_DEBUG'：在MCP响应中包含调试信息

  2. 调用工具：通过MCP协议的tools/call方法调用codex、gemini、claude或opencode

  3. 参数说明：

    • 'prompt'：任务指令
    • 'workspace'：项目目录的绝对路径
    • 'permission'：权限级别（read-only、workspace-write、unlimited）

  4. 会话管理：使用'continuation_id'参数维持对话上下文

环境配置示例

# 启用调试模式
export CAM_DEBUG=true
export CAM_LOG_DEBUG=true

# 限制可用工具
export CAM_TOOLS="codex,claude"

信息

分类

AI与计算

访问项目