ssh_set_working_directory
Change the current working directory for an SSH connection to navigate remote file systems and execute commands from a specific location.
Instructions
Set the current working directory for a connection
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| connectionId | Yes | SSH connection ID | |
| workingDirectory | Yes | Working directory path to set as current |
Implementation Reference
- src/index.ts:1250-1291 (handler)The handler function for 'ssh_set_working_directory' tool. Parses input, retrieves connection context, verifies the directory exists on the remote server using 'test -d', updates the connection's currentWorkingDirectory, and returns success message.
private async handleSetWorkingDirectory(args: unknown) { const params = SetWorkingDirectorySchema.parse(args); const context = connectionContexts.get(params.connectionId); if (!context) { throw new McpError( ErrorCode.InvalidParams, `Connection ID '${params.connectionId}' not found` ); } try { // Verify the directory exists const result = await context.ssh.execCommand(`test -d "${params.workingDirectory}" && echo "exists"`); if (result.code !== 0) { throw new McpError( ErrorCode.InvalidParams, `Directory '${params.workingDirectory}' does not exist or is not accessible` ); } // Set the working directory context.currentWorkingDirectory = params.workingDirectory; return { content: [ { type: 'text', text: `Working directory set to: ${params.workingDirectory}`, }, ], }; } catch (error) { if (error instanceof McpError) { throw error; } throw new McpError( ErrorCode.InternalError, `Failed to set working directory: ${error instanceof Error ? error.message : String(error)}` ); } } - src/index.ts:148-151 (schema)Zod schema defining the input parameters for the ssh_set_working_directory tool: connectionId (string) and workingDirectory (string).
const SetWorkingDirectorySchema = z.object({ connectionId: z.string().describe('SSH connection ID'), workingDirectory: z.string().describe('Working directory path to set as current') }); - src/index.ts:421-431 (registration)Registration of the 'ssh_set_working_directory' tool in the ListTools response, including name, description, and input schema matching the Zod schema.
name: 'ssh_set_working_directory', description: 'Set the current working directory for a connection', inputSchema: { type: 'object', properties: { connectionId: { type: 'string', description: 'SSH connection ID' }, workingDirectory: { type: 'string', description: 'Working directory path to set as current' } }, required: ['connectionId', 'workingDirectory'] }, }, - src/index.ts:513-514 (registration)Dispatch case in the CallToolRequest handler that routes to the handleSetWorkingDirectory method.
case 'ssh_set_working_directory': return await this.handleSetWorkingDirectory(args); - src/index.ts:25-29 (helper)Interface for connection context that stores the currentWorkingDirectory used by the set working directory handler.
interface ConnectionContext { ssh: NodeSSH; currentWorkingDirectory?: string; defaultWorkingDirectory?: string; }