项目简介

Ghost是一款强大的后台进程管理器,专为Unix系统(Linux, macOS, BSD)设计。它允许用户在没有常驻守护进程的情况下运行后台命令,并提供一个终端用户界面(TUI)进行任务监控、重跑和检查。此外,Ghost还提供了一个MCP服务器模式,使其能够与AI助手集成,实现通过AI指令来管理系统后台任务。

主要功能点

  • 后台命令管理: 运行、列出、停止、检查后台命令。
  • 日志捕获与实时查看: 自动捕获任务日志并支持实时跟踪。
  • 端口检测: 当lsof可用时,检测后台进程正在监听的端口。
  • AI助手集成: 作为MCP服务器,允许AI助手通过工具调用方式管理系统进程。
  • TUI仪表盘: 提供直观的终端界面来监控和管理任务。

安装步骤

  1. 安装Rust: 确保您的系统已安装Rust 1.80+ (2024 edition)。如果没有,请访问 rustup.rs 进行安装。
  2. 克隆仓库: 打开终端,执行以下命令克隆Ghost仓库:
    git clone https://github.com/skanehira/ghost.git
    cd ghost
  3. 构建二进制文件: 编译项目:
    cargo build --release
    编译后的可执行文件位于 'target/release/ghost'。
  4. (可选)下载预构建二进制文件: 如果不想从源代码构建,可以直接从 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

信息

分类

开发者工具