项目简介
Ghost是一款强大的后台进程管理器,专为Unix系统(Linux, macOS, BSD)设计。它允许用户在没有常驻守护进程的情况下运行后台命令,并提供一个终端用户界面(TUI)进行任务监控、重跑和检查。此外,Ghost还提供了一个MCP服务器模式,使其能够与AI助手集成,实现通过AI指令来管理系统后台任务。
主要功能点
- 后台命令管理: 运行、列出、停止、检查后台命令。
- 日志捕获与实时查看: 自动捕获任务日志并支持实时跟踪。
- 端口检测: 当lsof可用时,检测后台进程正在监听的端口。
- AI助手集成: 作为MCP服务器,允许AI助手通过工具调用方式管理系统进程。
- TUI仪表盘: 提供直观的终端界面来监控和管理任务。
安装步骤
- 安装Rust: 确保您的系统已安装Rust 1.80+ (2024 edition)。如果没有,请访问 rustup.rs 进行安装。
- 克隆仓库: 打开终端,执行以下命令克隆Ghost仓库:
git clone https://github.com/skanehira/ghost.git cd ghost - 构建二进制文件: 编译项目:
编译后的可执行文件位于 'target/release/ghost'。cargo build --release - (可选)下载预构建二进制文件: 如果不想从源代码构建,可以直接从 GitHub Releases 页面下载最新预构建的二进制文件。
MCP服务器配置
为了让MCP客户端能够连接并使用Ghost MCP服务器,您需要配置客户端以启动Ghost服务器。以下是配置示例:
{ "server_name": "ghost-mcp", "command": "target/release/ghost", "args": ["mcp"], "description": "Ghost MCP Server for managing background processes. Provides tools to run, list, stop, check status, cleanup old tasks, and view logs for processes." }
参数注释:
- 'server_name': 服务器的唯一标识符,建议保持为 'ghost-mcp'。
- 'command': 启动Ghost服务器的可执行文件路径。如果您从源代码构建,通常是 'target/release/ghost'。如果您下载了预构建二进制文件,请将其路径替换为实际的二进制文件路径。
- 'args': 启动Ghost MCP服务器所需的命令行参数,固定为 '["mcp"]'。
- 'description': 对MCP服务器功能的简要描述,供AI助手参考。
基本使用方法 (作为命令行工具)
- 运行后台命令:
./target/release/ghost run echo "Hello, Ghost" - 列出任务:
./target/release/ghost list - 查看任务日志: (将 '<task_id>' 替换为实际的任务ID)
./target/release/ghost log -f <task_id> - 启动TUI仪表盘:
./target/release/ghost
信息
分类
开发者工具