search_logs
Search local log files for specific text patterns to identify errors, debug applications, and monitor system activity.
Instructions
Search for specific text in log files
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_logs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Text to search for in logs | |
| filename | No | Log file to search (default: combined.log) | combined.log |
| lines | No | Number of matching lines to return (default: 10) |
Implementation Reference
- local-logs-mcp-server.js:399-436 (handler)The `searchLogs` method that executes the tool logic: reads the specified log file, searches for lines containing the query (case-insensitive), collects up to `maxLines` matches with line numbers and extracted timestamps, and returns structured results.
searchLogs(query, filename = 'combined.log', maxLines = 10) { try { const filePath = path.join(this.logsDir, filename); if (!fs.existsSync(filePath)) { return { matches: [], message: `Log file ${filename} not found`, query, filename }; } const content = fs.readFileSync(filePath, 'utf8'); const lines = content.split('\n'); const matches = []; for (let i = 0; i < lines.length && matches.length < maxLines; i++) { if (lines[i].toLowerCase().includes(query.toLowerCase())) { matches.push({ lineNumber: i + 1, content: lines[i].trim(), timestamp: this.extractTimestamp(lines[i]) }); } } return { matches, query, filename, matchCount: matches.length, message: `Found ${matches.length} matches for "${query}" in ${filename}` }; } catch (error) { return { matches: [], error: error.message, query, filename }; } } - local-logs-mcp-server.js:164-187 (schema)Input schema for the `search_logs` tool as returned in `tools/list`, defining required `query` parameter and optional `filename` and `lines`.
{ name: 'search_logs', description: 'Search for specific text in log files', inputSchema: { type: 'object', properties: { query: { type: 'string', description: 'Text to search for in logs' }, filename: { type: 'string', description: 'Log file to search (default: combined.log)', default: 'combined.log' }, lines: { type: 'number', description: 'Number of matching lines to return (default: 10)', default: 10 } }, required: ['query'] } } - local-logs-mcp-server.js:231-233 (registration)Registration/dispatch in the `handleToolCall` switch statement that routes `tools/call` for 'search_logs' to the handler method.
case 'search_logs': result = this.searchLogs(args?.query, args?.filename, args?.lines); break;