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