AI导哈

CLI终端管理协议

一个基于模型上下文协议（MCP）的服务，允许AI助手通过伪终端管理CLI会话和多服务项目架构。

  • by yksanjo
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 yksanjo/cli-manager-mcp

使用说明

cli管理器mcp

A. 模型上下文协议 （MCP）服务器，允许 AI助手（如Claude）管理交互式CLI终端会话和多服务 项目架构。它通过以下方式生成真正的伪终端 node-pty运行命令， 捕获和检测输出，并编排JSON中描述的项目定义 配置文件。

它提供什么

服务器通过stdio公开MCP工具，包括：

  • 终端会话： create_terminal, execute_command, send_input, get_terminal_output, list_terminals, close_terminal, open_terminal_window(s)
  • 项目编排： load_project, list_projects, get_project_info, setup_project, start_project, stop_project, execute_project_command, execute_service_command, check_dependencies

项目架构被定义为JSON（参见 config/ 示例目录 例如monorepo、微服务和单应用布局）。

技术栈

  • TypeScript（编译为 dist/ 和 tsc)
  • @modelcontextprotocol/sdk （MCP服务器、stdio传输）
  • node-pty 用于真实的终端会话
  • zod 用于工具参数验证
  • uuid 用于会话ID

需要Node.js>=18。

安装/构建

npm install      # runs the build via the "prepare" script
# or build manually:
npm run build    # tsc -> dist/index.js

install.sh 是一个方便的安装程序，可以检查Node、安装deps和构建。

用法

作为MCP stdio服务器运行：

npm start        # node dist/index.js

向MCP客户端（例如Claude Desktop）注册，并指向以下命令 node /absolute/path/to/dist/index.js。参见 docs/QUICK_START.md 和 docs/USAGE_EXAMPLES.md 用于客户端配置和示例。

脚本

  • npm run build –将TypeScript编译为 dist/
  • npm run dev –在手表模式下编译
  • npm start –运行内置服务器

存储库结构

src/      # MCP server implementation (index.ts)
config/   # Example project architecture definitions (JSON)
docs/     # Architecture, quick start, usage examples, roadmap

相关 MCP