MCP SSH Server

Instructions

Implementation Reference

• src/index.ts:1440-1484 (handler)

  The handler function that parses input, retrieves SSH connection context, executes 'docker ps -a' and optionally 'docker-compose ps' to check Docker container status, and returns the output.

  private async handleDockerStatus(args: unknown) {
    const params = DockerStatusSchema.parse(args);
    
    const context = connectionContexts.get(params.connectionId);
    if (!context) {
      throw new McpError(
        ErrorCode.InvalidParams,
        `Connection ID '${params.connectionId}' not found`
      );
    }
  
    try {
      const workingDir = params.workingDirectory || context.currentWorkingDirectory;
      
      // Get Docker container status
      const psResult = await context.ssh.execCommand('docker ps -a', {
        cwd: workingDir,
      });
      
      // Get Docker Compose status if compose file exists
      let composeStatus = '';
      if (workingDir) {
        const composeResult = await context.ssh.execCommand('docker-compose ps', {
          cwd: workingDir,
        });
        if (composeResult.code === 0) {
          composeStatus = `\n\nDocker Compose Status:\n${composeResult.stdout}`;
        }
      }
      
      return {
        content: [
          {
            type: 'text',
            text: `Docker Status (${workingDir || 'current directory'}):\n\nContainer Status:\n${psResult.stdout}${composeStatus}`,
          },
        ],
      };
    } catch (error) {
      throw new McpError(
        ErrorCode.InternalError,
        `Failed to get Docker status: ${error instanceof Error ? error.message : String(error)}`
      );
    }
  }

• src/index.ts:171-174 (schema)

  Zod schema defining the input parameters for the ssh_docker_status tool: connectionId (required) and optional workingDirectory.

  const DockerStatusSchema = z.object({
    connectionId: z.string().describe('SSH connection ID'),
    workingDirectory: z.string().optional().describe('Working directory to check (defaults to current)')
  });

• src/index.ts:464-475 (registration)

  Tool registration in the listTools response, including name, description, and inputSchema matching the handler.

  {
    name: 'ssh_docker_status',
    description: 'Check Docker container status in working directory',
    inputSchema: {
      type: 'object',
      properties: {
        connectionId: { type: 'string', description: 'SSH connection ID' },
        workingDirectory: { type: 'string', description: 'Working directory to check (defaults to current)' }
      },
      required: ['connectionId']
    },
  },

• src/index.ts:519-520 (registration)

  Dispatch case in the CallToolRequest handler switch statement that routes to the handleDockerStatus method.

  case 'ssh_docker_status':
    return await this.handleDockerStatus(args);