Orchestra插件：devtools日志查看器
日志文件查看器、搜索和后台流程管理工具 乐团MCP 框架。
安装
orchestra plugin install github.com/orchestra-mcp/plugin-devtools-log-viewer
工具
日志文件工具
| 工具 | 说明 |
|---|
log_tail | 读取日志文件的最后N行 |
log_watch | 返回日志文件最后N行的快照 |
log_search | 在日志文件中搜索与正则表达式匹配的行，并使用上下文行 |
log_parse | 使用JSON、syslog或自动检测解析日志文件 |
log_list_sources | 列表 .log 目录或公共日志位置中的文件 |
流程管理工具
| 工具 | 说明 |
|---|
log_run | 在后台运行shell命令并捕获其输出 |
log_run_status | 检查后台进程的状态（正在运行/已完成/失败） |
log_run_output | 获取捕获的输出，可选择按正则表达式过滤 |
log_run_kill | 杀死一个正在运行的进程（SIGTERM，然后在3秒后SIGKILL） |
log_run_restart | 使用相同的命令杀死并重新运行进程 |
log_run_list | 列出所有跟踪的后台进程 |
使用示例
查看日志文件
log_tail path="/var/log/system.log" lines=50
log_search path="/var/log/system.log" pattern="ERROR" context_lines=3
log_parse path="/tmp/app.log" format="json"
log_list_sources directory="/var/log"
运行和管理后台进程
# Start a dev server
log_run command="make dev" working_directory="/path/to/project"
# Returns: proc-a1b2c3d4
# Check status and recent output
log_run_status id="proc-a1b2c3d4" tail=20
# Search output for errors
log_run_output id="proc-a1b2c3d4" pattern="ERROR|WARN"
# Restart after code changes
log_run_restart id="proc-a1b2c3d4"
# Stop the server
log_run_kill id="proc-a1b2c3d4"
# See all running processes
log_run_list
建筑
- 日志文件工具 是无状态的——每个调用都直接从文件系统读取
- 流程管理工具 是有状态的——插件维护一个内存映射
ManagedProcess 结构体，每个都有一个线程安全的环形缓冲区（1000行），用于捕获stdout+stderr的组合 - 命令通过运行
sh -c 随着 Setpgid: true 因此，杀死信号会到达整个进程组 - 插件关闭时，所有托管进程都会被终止
相关包
