mcp-daemonize

mcp-daemonize

mcp-daemonize 是一个 Model Context Protocol (MCP) 服务，旨在为 Claude Code 和 Cline 等 AI Agent 无缝管理长时间运行的守护进程（例如开发服务器）。它允许 AI Agent 启动、停止和监控守护进程，并实时访问其日志，从而实现高级自动化和调试功能。

动机

AI Agent 虽然可以执行命令，但并不适合管理长时间运行的开发服务器（例如 vite dev）。这是因为 Agent 通常会等待命令完成，而对于开发期间需要持续运行的服务器，这种方式并不适用。作为变通方法，用户通常会在单独的 Shell 中启动开发服务器，但这样 AI Agent 就无法直接访问服务器日志，因而无法自主调试。

mcp-daemonize 通过提供以下功能解决这些问题：

• 提供无需等待进程终止即可启动守护进程的接口。
• 提供停止正在运行的守护进程的工具。
• 提供查看正在运行的守护进程实时日志的工具。

借助这些功能，mcp-daemonize 使 AI Agent 能够全面管理开发服务器、监控其输出并执行自动化调试，大大拓展了自主编码的可能性。

使用场景

• 通过 AI Agent 启动和停止开发服务器（例如 Vite、Next.js 等）。
• 查看并分析正在运行的守护进程实时日志，以便调试。
• 自动化需要持久后台进程的开发工作流。
• 让 AI Agent 能够自主管理、监控和调试长时间运行的进程。

前置条件

1. 已安装 Go 1.24.2 或更高版本。
2. （可选）如果希望在容器中运行 mcp-daemonize，则需要 Docker。

安装

从 GitHub Releases 下载

访问 Releases 页面下载最新版本。

1. 从最新的发布页面下载适用于你平台的压缩包。
2. 解压压缩包，并将二进制文件移至 PATH 中的某个目录。

wget https://github.com/mackee/mcp-daemonize/releases/download/vX.Y.Z/mcp-daemonize_X.Y.Z_Darwin_x86_64.tar.gz
tar -xzf mcp-daemonize_X.Y.Z_Darwin_x86_64.tar.gz
sudo mv mcp-daemonize /usr/local/bin/

从源代码构建

你可以使用 go install 安装最新版本（需要 Go 1.24.2 或更高版本）：

go install github.com/mackee/mcp-daemonize/cmd/mcp-daemonize@latest

与 MCP 主机配合使用（例如 Claude Code、Cline）

将以下配置添加到 MCP 主机设置中（例如 mcp.json）：

{
  "servers": {
    "daemonize": {
      "command": "/path/to/mcp-daemonize",
      "args": [],
      "env": {}
    }
  }
}

将 /path/to/mcp-daemonize 替换为构建所得二进制文件的实际路径。

用法

mcp-daemonize 为 AI Agent 提供以下工具：

工具

• daemonize_start

  • 将长时间运行的进程（例如开发服务器）作为守护进程启动。
  • 参数：
    • name（字符串，必填）：守护进程的名称。
    • command（字符串数组，可选）：要运行的命令（例如 ["npm", "run", "dev"]）。
    • workdir（字符串，必填）：守护进程的工作目录（绝对路径）。

• daemonize_stop

  • 按名称停止正在运行的守护进程。
  • 参数：
    • name（字符串，必填）：要停止的守护进程名称。

• daemonize_list

  • 列出当前正在运行的所有守护进程。
  • 参数： 无

• daemonize_logs

  • 获取正在运行的守护进程的最新日志。
  • 参数：
    • name（字符串，必填）：守护进程的名称。
    • tail（数字，必填）：从日志末尾读取的行数。

示例工作流

1. 使用 daemonize_start 将开发服务器作为守护进程启动。
2. 使用 daemonize_logs 实时监控服务器输出。
3. 完成后，使用 daemonize_stop 停止服务器。

许可证

本项目根据 MIT 开源许可证的条款授权。详情请参阅 LICENSE。