mcp-daemonize

mcp-daemonize 是一个 模型上下文协议 (MCP) 服务器，旨在为像 Claude Code 和 Cline 这样的 AI 代理提供长期运行守护进程（如开发服务器）的无缝管理。它通过允许 AI 代理启动、停止和监控守护进程以及实时访问它们的日志，提供了高级自动化和调试功能。

动机

虽然 AI 代理可以执行命令，但它们并不适合管理长期运行的开发服务器（例如 vite dev）。这是因为代理通常会等待命令完成，这不适合那些在开发过程中需要持续运行的服务器。作为一种解决方法，用户经常在单独的 shell 中启动开发服务器，但这阻止了 AI 代理直接访问服务器日志，使得自主调试成为不可能。

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

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

借助这些功能，mcp-daemonize 允许 AI 代理完全管理开发服务器，监控其输出并进行自动调试，极大地扩展了自主编码的可能性。

使用场景

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

预备条件

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

安装

从 GitHub 发布下载

访问 发布页面 下载最新版本。

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 代理使用：

工具

• 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。