MCP Sumo Logic

一个与 Sumo Logic API 集成的模型上下文协议 (MCP) 服务器，用于执行日志搜索。

功能

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

环境变量

ENDPOINT=https://api.au.sumologic.com/api/v1  # Sumo Logic API 端点
SUMO_API_ID=your_api_id                       # Sumo Logic API ID
SUMO_API_KEY=your_api_key                     # Sumo Logic API 密钥

设置

1. 克隆存储库
2. 安装依赖项：

   npm install
   

3. 创建一个包含所需环境变量的 .env 文件
4. 构建项目：

   npm run build
   

5. 启动服务器：

   npm start
   

Docker 设置

1. 构建 Docker 镜像：

   docker build -t mcp/sumologic .
   

2. 运行容器（选择一种方法）：

   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=app_pro_fiat_cont | 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