日志服务工具

MCP Logger是一个允许AI助手通过Syslog基础设施进行日志记录和监控的工具,支持多语言字符处理和双模式操作(CLI和MCP)。

  • by veltrea
  • Rust
  • 本地部署
  • 更新于
在 GitHub 查看 veltrea/mcp-logger

使用说明

MCP记录仪(英语 | 日本语 | 韩语 | 简体中文 | 繁体中文 | 越南语 | 泰语 | 印地语 | 阿拉伯语 | 俄语)

概述

该项目提供了一个MCP(模型上下文协议)服务器,使AI助手(如Claude、Gemini等)能够利用Syslog基础设施进行日志记录和监控。 它本身不是“Syslog服务器”,而是AI向现有Syslog服务器发送日志的“客户端功能”(例如。, rsyslog, syslog-ng,或 vlt-syslogd).

它与以下内容共享核心逻辑 rust-logger (人类的CLI记录器),同时提供针对AI交互优化的界面。

主要特点

  • 发送Syslog消息:AI可以指定要发送Syslog的服务器、端口、设施、严重性、标签、编码和消息。
  • 2字节字符支持(UTF-8带BOM):专门设计用于正确处理非ASCII字符(日语、韩语、中文等)以进行AI分析。
  • CLI-MCP双重设计:既可作为人类的独立CLI工具,也可作为人工智能的MCP服务器。

安装

需要Rust环境。

cargo build --release

用法(CLI/MCP双模式)

该工具结合了“CLI for Humans”和“MCP Server for AI”。

1.人工CLI模式

您可以直接从终端发送日志。

# Basic send
mcp-logger send 192.168.1.100 "Hello from CLI"

# With options
mcp-logger send 192.168.1.100 "Error occurred" --severity error --tag my-app

跑步 mcp-logger 如果终端中没有参数,将显示 MCP设置指南.

2.人工智能辅助模式(MCP)

将以下内容添加到您的 claude_desktop_config.json 或等效物。

{
  "mcpServers": {
    "mcp-logger": {
      "command": "/path/to/mcp-logger",
      "args": ["run-mcp"]
    }
  }
}

MCP工具

为AI提供的功能。

send-syslog

向指定服务器发送Syslog消息。

论据:

  • server (字符串,必填):Syslog服务器的主机名或IP。
  • port (number):端口号(默认值: 514).
  • facility (string):设施(例如。, user, local0).默认值为 user.
  • severity (string):严重性(例如。, info, error).默认值为 info.
  • tag (string):程序名称(标签)。默认值为 mcp-syslog.
  • encoding (string):编码(例如。, utf-8, shift_jis).默认值为 utf-8.
  • message (string,必填):日志消息正文。

重要提示:多字节字符处理

对于使用2字节字符的语言(日语、中文、韩语等),AI被指示使用 utf-8。服务器自动附加 UTF-8炸弹 以确保Syslog服务器和后续分析工具正确识别编码。

文档