AI导哈

日志聚合工具

Logdump是一个实时日志聚合工具，具有终端用户界面（TUI）和MCP服务器功能，适用于AI代理的日志管理。

  • by AppGram
  • Go
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 AppGram/logdump

使用说明

日志转储

用于AI代理的实时日志聚合工具，带有TUI和MCP服务器。

特性

  • 实时日志跟踪 -同时查看多个日志文件
  • 美丽的TUI -带有颜色编码流、搜索和导航的终端UI
  • MCP服务器 -通过模型上下文协议将日志暴露给AI代理
  • 自动发现 -自动查找 .log 和 .txt 日志目录中的文件
  • 流过滤 -打开/关闭流，使用正则表达式搜索
  • 反向模式 -在顶部或底部查看最新日志
  • 代码已签名 -macOS二进制文件已使用开发人员ID签名

安装

自制（macOS/Linux）

brew tap appgram/tap
brew install logdump

直接下载（macOS、Linux、Windows）

从下载预构建的二进制文件 发布页面:

# macOS Apple Silicon
curl -L https://github.com/appgram/logdump/releases/download/v1.0.1/logdump_v1.0.1_darwin_arm64.tar.gz | tar xz
chmod +x logdump
mv logdump /usr/local/bin/

# macOS Intel
curl -L https://github.com/appgram/logdump/releases/download/v1.0.1/logdump_v1.0.1_darwin_amd64.tar.gz | tar xz
chmod +x logdump
mv logdump /usr/local/bin/

# Linux x86_64
curl -L https://github.com/appgram/logdump/releases/download/v1.0.1/logdump_v1.0.1_linux_amd64.tar.gz | tar xz
chmod +x logdump
sudo mv logdump /usr/local/bin/

# Linux ARM64
curl -L https://github.com/appgram/logdump/releases/download/v1.0.1/logdump_v1.0.1_linux_arm64.tar.gz | tar xz
chmod +x logdump
sudo mv logdump /usr/local/bin/

来源

git clone https://github.com/appgram/logdump.git
cd logdump
./install.sh

去安装

go install github.com/appgram/logdump@latest

用法

TUI模式

# Run with auto-discovery of log files
logdump

# Only show new logs (skip history)
logdump -tail

# Exclude specific streams
logdump -exclude mcp-activity,sample

# Use custom config
logdump -config /path/to/config.yaml

MCP服务器模式

# Start MCP server for AI agents
logdump -mcp

TUI键盘快捷键

关键 行动
↑/↓ 或 j/k 浏览日志条目
Enter 查看日志详细信息
/ 搜索（正则表达式）
s 显示所有流
1-9 打开/关闭流
a 选择所有流
n 取消选择所有流
r 逆序（最新顶部/底部）
p 或 Space 暂停/恢复
c 清除日志
g / G 转到顶部/底部
q 退出

配置

Logdump使用位于以下位置的YAML配置文件 ~/.config/logdump.yaml:

# Log directory for auto-discovery
log_dir: ~/.local/share/logdump/logs

# Manual stream definitions (optional)
streams:
  - name: myapp
    path: /var/log/myapp
    patterns:
      - "*.log"
    color: cyan

# Log groups for filtering
groups:
  - name: errors
    pattern: "ERROR|FATAL|ERR"
    color: red

流颜色

可用颜色： red, green, blue, yellow, cyan, magenta, white

MCP集成

Logdump通过以下方式向AI代理公开日志 模型上下文协议.

Claude代码设置

添加到您的Claude Code MCP设置中：

{
  "mcpServers": {
    "logdump": {
      "command": "logdump",
      "args": ["-mcp"]
    }
  }
}

可用的MCP工具

工具 说明
logdump_read 读取日志条目（带可选的源/组筛选器）
logdump_grep 使用正则表达式模式搜索日志
logdump_streams 列出所有活动日志流
logdump_groups 列出日志组
logdump_create_group 创建新日志组
logdump_stats 获取缓冲区和流统计信息
logdump_access_log 查看代理访问历史记录

为代理编写日志

应用程序可以将日志写入共享目录以供代理访问：

# Default log directory
~/.local/share/logdump/logs/

# Example: write from your app
echo "[$(date)] INFO Starting service" >> ~/.local/share/logdump/logs/myapp.log

建筑

# Build
make build

# Build and sign (macOS)
make build-signed

# Install locally
make install

# Run tests
make test

需求

  • 转到1.21+
  • macOS、Linux或Windows

许可证

MIT许可证-请参阅 许可证

贡献

欢迎投稿！请打开问题或提交拉取请求。

相关 MCP