MCP Sumo Logic

Name: MCP Sumo Logic
Author: samwang0723

本地服务

github.com/samwang0723云与基础设施1134 周前更新

代码仓库

关于 MCP Sumo Logic

MCP Sumo Logic 通过 Sumo Logic API 搜索日志，面向需要查询日志的用户。它支持自定义查询和可选时间范围，也可通过 Docker 部署。

主要功能

01使用自定义查询搜索日志
02设置搜索时间范围
03错误处理与详细日志
04Docker 部署

适用场景

01使用查询排查日志
02将搜索限定在指定时段

MCP 相关

它向 MCP 客户端提供 `search-sumologic` 工具，接收查询语句以及可选的起止时间。

#mcp-sumologic #log-search #api-integration

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "sumologic": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "build"
      ]
    }
  }
}

启动命令docker run -i --rm build

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

ocibuildstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

MCP Sumo Logic

一个 Model Context Protocol（MCP）服务，可集成 Sumo Logic 的 API 以执行日志搜索。

功能

使用自定义查询搜索 Sumo Logic 日志
可配置搜索的时间范围
错误处理和详细日志记录
支持 Docker，便于部署

环境变量

ENDPOINT=https://{host}/api/v1  # Sumo Logic API endpoint
SUMO_API_ID=your_api_id                       # Sumo Logic API ID
SUMO_API_KEY=your_api_key                     # Sumo Logic API Key

设置

克隆仓库
安装依赖：
```
npm install
```
创建包含所需环境变量的 .env 文件
构建项目：
```
npm run build
```
启动服务：
```
npm start
```

Docker 设置

构建 Docker 镜像：
```
docker build -t mcp/sumologic .
```

运行容器（选择一种方式）：

a. 直接使用环境变量：

docker run -e ENDPOINT=your_endpoint -e SUMO_API_ID=your_api_id -e SUMO_API_KEY=your_api_key mcp/sumologic

b. 使用 .env 文件：

docker run --env-file .env mcp/sumologic

注意：确保你的 .env 文件包含所需的环境变量：

ENDPOINT=your_endpoint
SUMO_API_ID=your_api_id
SUMO_API_KEY=your_api_key

用法

该服务提供一个 search-sumologic 工具，接受以下参数：

query（必填）：Sumo Logic 搜索查询
from（可选）：ISO 8601 格式的开始时间
to（可选）：ISO 8601 格式的结束时间

查询示例：

const query = '_index={index} | json auto | fields log_identifier';
const results = await search(sumoClient, query, {
  from: '2024-02-23T00:00:00Z',
  to: '2024-02-24T00:00:00Z',
});

错误处理

该服务包含完善的错误处理和日志记录：

捕获 API 错误并记录详细信息
监控并记录搜索任务状态
妥善处理网络和身份验证问题

开发

以开发模式运行：

npm run dev

测试：

npm test

Makefile

可通过 make 执行常见任务：

命令	描述
`make install`	安装依赖
`make build`	构建项目
`make start`	启动服务
`make dev`	以开发模式启动（自动重新加载）
`make clean`	移除 `dist/` 和 `node_modules/`
`make lint`	运行 ESLint
`make test`	运行测试
`make docker-build`	构建 Docker 镜像
`make docker-run`	使用 `.env` 文件在端口 3006 上运行容器
`make docker-compose`	通过 Docker Compose 启动服务
`make docker-down`	停止 Docker Compose 服务