使用说明
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服务器和后续分析工具正确识别编码。