neoai-agent/coralogix-mcp
GitHub: neoai-agent/coralogix-mcp
基于 MCP 的命令行工具,利用 AI 提升 Coralogix 日志的查询与分析效率。
Stars: 11 | Forks: 3
# Coralogix MCP Server
一个使用 MCP(Model Control Protocol)监控和分析 Coralogix 日志的命令行工具。
## 安装
使用 pipx 从 GitHub 直接安装:
```
# 安装
pipx install git+https://github.com/neoai-agent/coralogix-mcp.git
# 无需安装即可运行
pipx run git+https://github.com/neoai-agent/coralogix-mcp.git
```
## 快速开始
使用您的凭证运行服务器:
```
coralogix-mcp --coralogix-api-key "YOUR_CORALOGIX_API_KEY" \
--openai-api-key "YOUR_OPENAI_API_KEY"
```
## 可用工具
coralogix-mcp 软件包提供以下用于与 Coralogix 日志交互的 MCP 工具:
1. **get_2xx_logs** - 分析来自 Coralogix 的 2XX 成功日志,并提供 API 端点统计信息
- 返回显示请求数最多的端点分析
- 可选 `service_name` 参数用于按特定服务过滤
2. **get_4xx_logs** - 分析来自 Coralogix 的 4XX 客户端错误日志
- 返回带有端点统计信息的 API 分析
- 包含最近 2 分钟内的错误详情
- 显示总错误数
- 可选 `service_name` 参数用于按特定服务过滤
3. **get_5xx_logs** - 分析来自 Coralogix 的 5XX 服务器错误日志
- 返回带有端点统计信息的 API 分析
- 包含最近 2 分钟内的错误详情
- 显示总错误数
- 可选 `service_name` 参数用于按特定服务过滤
4. **get_coralogix_logs_by_string** - 搜索包含特定字符串的日志并返回匹配项周围的上下文
- 必需的 `search_string` 参数用于指定搜索内容
- 可选 `service_name` 参数用于按特定服务过滤
- 可选 `context_lines` 参数(默认值:100)用于指定匹配项周围的上下文行数
- 返回带有周围上下文的日志条目,便于调试
所有工具自动处理以下功能:
- 服务名称匹配与验证
- 时间范围过滤(默认:最近 15 分钟)
- 错误处理与日志记录
- JSON 响应格式化
如需了解更多信息,请运行:
```
coralogix-mcp --help
```
## 开发
使用虚拟环境进行开发设置:
```
# 克隆存储库
git clone https://github.com/neoai-agent/coralogix-mcp.git
cd coralogix-mcp
# 设置虚拟环境
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# 安装开发依赖项
pip install -e ".[dev]"
```
## 许可证
MIT 许可证 - 详细信息请参见 [许可证文件](LICENSE)。
标签:AI-powered insights, AI 洞察, API 监控, command-line tool, context extraction, Coralogix, coralogix-mcp, error tracking, log analysis, log monitoring, MCP, Model Control Protocol, Petitpotam, pipx, 实时错误追踪, 文档结构分析, 日志上下文提取, 日志检索, 智能分析, 服务端日志, 监控, 逆向工具