Super Windows CLI MCP Server

Instructions

{
  "limit": 5
}

[
  {
    "command": "Get-Process",
    "output": "...",
    "timestamp": "2024-03-20T10:30:00Z",
    "exitCode": 0
  }
]

Implementation Reference

• src/index.ts:438-469 (handler)

  Handler for the get_command_history tool: checks if logging is enabled, validates input limit with Zod schema, retrieves recent history entries from this.commandHistory, truncates outputs, 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/types/config.ts:52-58 (schema)

  Type definition for CommandHistoryEntry, which structures the data returned by the get_command_history tool.

  export interface CommandHistoryEntry {
    command: string;
    output: string;
    timestamp: string;
    exitCode: number;
    connectionId?: string;
  }

• src/index.ts:176-207 (registration)

  Tool registration in ListTools handler, including name, description, and inputSchema for get_command_history.

          {
            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})`
                }
              }
            }
          },