get_command_history
Retrieve the history of executed commands from the Super Windows CLI MCP Server, including command details, output, timestamps, and exit codes, with adjustable entry limits.
Instructions
Get the history of executed commands
Example usage:
{
"limit": 5
}
Example response:
[
{
"command": "Get-Process",
"output": "...",
"timestamp": "2024-03-20T10:30:00Z",
"exitCode": 0
}
]
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of history entries to return (default: 10, max: 1000) |
Implementation Reference
- src/index.ts:438-469 (handler)Handler for the 'get_command_history' tool. Checks if command logging is enabled, parses optional limit parameter, slices the recent history entries from this.commandHistory, limits output length, and returns them as formatted JSON.case "get_command_history": { if (!this.config.security.logCommands) { return { content: [{ type: "text", text: "Command history is disabled in configuration. Consult the server admin for configuration changes (config.json - logCommands)." }] }; } const args = z.object({ limit: z.number() .min(1) .max(this.config.security.maxHistorySize) .optional() .default(10) }).parse(request.params.arguments); const history = this.commandHistory .slice(-args.limit) .map(entry => ({ ...entry, output: entry.output.slice(0, 1000) // Limit output size })); return { content: [{ type: "text", text: JSON.stringify(history, null, 2) }] }; }
- src/index.ts:176-207 (registration)Registration of the 'get_command_history' tool in the list of available tools, including name, description, and inputSchema for optional 'limit' parameter (number, default 10, max from config).{ name: "get_command_history", description: `Get the history of executed commands Example usage: \`\`\`json { "limit": 5 } \`\`\` Example response: \`\`\`json [ { "command": "Get-Process", "output": "...", "timestamp": "2024-03-20T10:30:00Z", "exitCode": 0 } ] \`\`\``, inputSchema: { type: "object", properties: { limit: { type: "number", description: `Maximum number of history entries to return (default: 10, max: ${this.config.security.maxHistorySize})` } } } },
- src/index.ts:448-454 (schema)Zod schema validation for the tool input arguments within the handler.const args = z.object({ limit: z.number() .min(1) .max(this.config.security.maxHistorySize) .optional() .default(10) }).parse(request.params.arguments);