Server Watch

server-watch-mcp

一个简单易用的 CLI 包装器，可监控并捕获任意运行中命令的输出，并将其作为 MCP 服务提供。非常适合需要访问服务日志、构建输出或任何进程输出的开发工作流。

功能

• 基于 HTTP 的 MCP 服务 - 作为独立服务运行，供客户端连接
• 实时日志捕获 - 捕获任意命令的标准输出和标准错误
• 循环缓冲区存储 - 在内存中保留最近 5000 条日志
• 两个 MCP 工具：
  • get_logs - 获取最近的日志，可按流类型进行筛选
  • search_logs - 通过不区分大小写的子字符串匹配搜索日志

安装

npm install -g server-watch-mcp
# or
pnpm add -g server-watch-mcp
# or in your project
pnpm add -D server-watch-mcp

使用方法

1. 将 MCP 服务添加到 Claude Code

claude mcp add -s user -t sse server-watch-mcp http://localhost:6280/sse

这会将其配置为：

{
  "mcpServers": {
    "server-watch-mcp": {
      "type": "sse", // Even though SSE is deprecated, Claude Code only supports SSE 
      "url": "http://localhost:6280/sse"
    }
  }
}

2. 使用你的命令启动 MCP 服务

选项 1：调用命令时进行包装

# Monitor a development server
server-watch-mcp npm run dev

# Monitor a build process
server-watch-mcp npm run build:watch

# Monitor any command
server-watch-mcp python app.py

选项 2：在 package.json（或脚本文件）中包装命令

// In your package.json
{
  "scripts": {
    "dev": "server-watch-mcp next dev --turbo",
  }
}

服务将会：

• 在端口 6280（或 SERVER_WATCH_MCP_PORT 环境变量指定的端口）启动 HTTP 服务
• 将你的命令作为子进程执行
• 捕获命令的所有输出
• 即使子进程退出，也会继续运行

3. 在 Claude 中使用工具

连接后，你可以使用这些工具：

• 获取最近的日志：“显示 stderr 中最近 50 条日志”
• 搜索日志：“搜索日志中是否有错误”
• 监控输出：“我的开发服务现在是什么情况？”

环境变量

SERVER_WATCH_MCP_PORT - 覆盖默认端口（6280）

SERVER_WATCH_MCP_PORT=6281 server-watch-mcp npm run dev

开发

# Install dependencies
pnpm install

# Build
pnpm run build

# Run tests
pnpm test

# Run in development
pnpm run dev

许可证

ISC