Desktop Commander MCP

Instructions

                    Stop an active search.
                    
                    Stops the background search process gracefully. Use this when you've found
                    what you need or if a search is taking too long. Similar to force_terminate
                    for terminal processes.
                    
                    The search will still be available for reading final results until it's
                    automatically cleaned up after 5 minutes.
                    
                    This command can be referenced as "DC: ..." or "use Desktop Commander to ..." in your instructions.

Implementation Reference

• src/handlers/search-handlers.ts:177-215 (handler)

  The main handler function for the 'stop_search' tool. It validates input using StopSearchArgsSchema, then calls searchManager.terminateSearch(sessionId) to stop the search process, returning appropriate success or error messages.

  /**
   * Handle stop_search command
   */
  export async function handleStopSearch(args: unknown): Promise<ServerResult> {
    const parsed = StopSearchArgsSchema.safeParse(args);
    if (!parsed.success) {
      return {
        content: [{ type: "text", text: `Invalid arguments for stop_search: ${parsed.error}` }],
        isError: true,
      };
    }
  
    try {
      const success = searchManager.terminateSearch(parsed.data.sessionId);
      
      if (success) {
        return {
          content: [{
            type: "text",
            text: `Search session ${parsed.data.sessionId} terminated successfully.`
          }],
        };
      } else {
        return {
          content: [{
            type: "text",
            text: `Search session ${parsed.data.sessionId} not found or already completed.`
          }],
        };
      }
    } catch (error) {
      const errorMessage = error instanceof Error ? error.message : String(error);
      
      return {
        content: [{ type: "text", text: `Error terminating search session: ${errorMessage}` }],
        isError: true,
      };
    }
  }

• src/tools/schemas.ts:188-190 (schema)

  Zod schema defining the input arguments for the stop_search tool: requires a 'sessionId' string.

  export const StopSearchArgsSchema = z.object({
    sessionId: z.string(),
  });

• src/search-manager.ts:268-283 (helper)

  Core helper method in SearchManager that terminates the ChildProcess of the search session by sending SIGTERM, returns true if session existed.

  terminateSearch(sessionId: string): boolean {
    const session = this.sessions.get(sessionId);
    
    if (!session) {
      return false;
    }
  
    if (!session.process.killed) {
      session.process.kill('SIGTERM');
    }
  
    // Don't delete session immediately - let user read final results
    // It will be cleaned up by cleanup process
    
    return true;
  }